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Rivista + "Le grandi guide di ioProgrammo" n°6 a € 1 2,90 in più 
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ROGRAMMO 



PER ESPERTI E PRINCIPIANTI 



DATABASE 

A PROVA DI CRASH 

Progetta applicazioni che non smettono di 
funzionare anche in caso di danni irreparabili 
come la rottura di un Hard Disk... 



TEORIA: Dal Failover al Clustering, 
cosa sono e come funzionano 



TECNICA: Il DB Mirroring, 
per avere una copia perfetta 
sempre OnLine in tempo reale 



PRATICA: Sviluppa in 
.NET software che sfrutta 
connessioni affidabili 

RECOVERING: 

Recupera un database 

o un file master danneggiato! 




CREA URI TUO PLUGIM PER 

GOOGLE DESKTOP 

Ecco come estendere l'applicazione più usata del momento 
aggiungendo un sistema di gestione degli appuntamenti... 



NOVITÀ 




FATTI IL BOT PER SKYPE 

Aggiungi nuove funzioni alla tua chat preferita 
con ruby e i web services 



MOBILE 



INTERNET APPLICATION 



LE MAPPE NEL PALMARE STAMPE DAL WEB PERFETTE 



Colloca su una cartina un indirizzo 
presente nella rubrica 



ALGORITMI 



Utilizza i CSS per ottenere layout professionali 
e compatibili con tutte le stampanti 



J Ecco come risolvere 
problemi procedendo per passi logici ben definiti 
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.SQLSERVER 



LAVORARE CON 
SERVICE BROKER 

DB non raggiungibile? 
Salva tutto in una coda 
e aggiorna quando possibile 

DA SQL A XML! 

Mai più conversioni 
difficoltose, ecco come 
far fare tutto al server 



VISUAL BASIC 



INVIA E RICEVI 
FILE SU INTERNET 

Sviluppa applicazioni che 
dialogano fra loro e sfruttano 
la rete per scambiare i dati 



RIDUCI LE RIGHE 
DI CODICE 

Programmi lunghissimi addio. 
Arriva il NameSpace MY che 
ti facilita la vita 



MENU DINAMICI 

Applicazioni accattivanti anche 
con Java. Come aggiungere 
icone e grafica 

ALLA CONQUISTA 
DEL DESKTOP 

Le nuove funzioni di Java 6. 
Un esempio completo di 
software ridotto nella traybar 

SQL NO PROBLEM 

Impara a usare Hibernate, 
il tool che trasforma tabelle 
e dati in oggetti! 
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L'Universo Tecnologia 
| Certificalo n.5B7D del 18/12/2005 www.itportal.it 



▼ Da Linux a Windows 



È successo un fatto strano! O almeno strano in rela- 
zione alla tendenza a cui eravamo abituati ad assi- 
stere negli ultimi anni. Evolution, il client email più 
utilizzato in ambito Linux funziona ora anche in 
ambiente Windows. Se fosse un fatto isolato ci 
sarebbe poco su cui discutere. Tuttavia il numero di 
applicazioni che nasce in ambiente Unix e viene 
portata in ambiente Windows comincia ad essere 
davvero elevato. Si pensi a Firefox, ad OpenOffice, a 
Sylpheed, ai vari Apache e company che da tempo 
producono una doppia versione. D'altra parte è 
vero anche il contrario, le applicazioni native in 
ambiente Windows continunano ad essere portate 
anche su Linux, e sono nati alcuni progetti che 
hanno addirittura lo scopo di cercare una compati- 
bilità binaria. In questa ottica come dobbiamo ade- 
guarci noi programmatori ad un mondo in cui le 
barriere, persino fra sistemi operativi, tendono ad 
assottigliarsi? La parola d'ordine è "flessibilità". 
Dobbiamo essere in grado, oggi più che mai di pro- 
gettare codice riusabile, facilmente adattabile alle 
varie esigenze ed ai vari sistemi operativi. Rimane il 
dubbio: "Quanto è utile specializzarsi in un'area 



della programmazione, piuttosto che avere un'infa- 
rinatura globale di tutto?" La risposta, come sempre 
non è assoluta. Molto probabilmente un mercato 
così flessibile merita una conoscenza di massima di 
ogni area tecnica, ma è anche vero che ogni pro- 
grammatore ha il dovere di specializzarsi in un par- 
ticolare settore quando se ne presenta l'esigenza. La 
formazione in tutto ciò ricopre, un ruolo essenziale. 
Ecco perché noi di ioProgrammo investiamo conti- 
nuamente in nuove tecniche che possano rendere 
la divugazione dell'informazione ancora più veloce, 
più facile da apprendere, pur conservando quel 
carattere di approfondimento che da oltre dieci 
anni ci caratterizza. Ecco perché accanto alla tradi- 
zionale riv ista cartacea, che contiene materiale che 
può essere "digerito" con la calma, di chi vuole 
approfondire, affianchiamo anche i video e gli altri 
materialiche invece rappresentamo un'informazio- 
ne più veloce, più pronta da essere usata subito, 
ancora una volta al fianco di chi prima di essere un 
programmatore, è un appassionato di tecnologia. 

Fabio Farnesi ffarnesi@edmaster. it 




All'inizio di ogni articolo, troverete un simbolo 
che indicherà la presenza di codice e/o software 
allegato, che saranno presenti sia sul CD (nella 
posizione di sempre \soft\codice\ e \soft\tools\) 
sia sul Web, all'indirizzo 
http://cdrom.ioprogrammo.it. 



DATABASE 

A PROVA DI CRASH 

Progetta applicazioni che non smettono 
di funzionare anche in caso di danni 
irreparabili come il Crash di un HD 



• TECNICA: il database mirroring 
per avere una copia perfetta 
sempre OnLine in tempo reale 

• TEORIA: Dal FailOver 
al Clustering, cosa sono 
e come funzionano? 

• PRATICA: costruire 
applicazioni che non 
si interrompono mai 

• RECOVERING: Come recuperare 
un DB o un file master danneggiato 




pag. 12 



Questo mese su ioProgrammo 



CREA UN TUO PLUGIN PER 
GOOGLE DESKTOP 

Ecco come estendere l'applicazione più usata del momento 
aggiungendo un sistema di gestione degli appuntamenti 

pag. 62 



IOPROGRAMMO WEB 



Stampa di pagine Web con Css 

pag. 22 

tutte le principali novità introdotte nella 
specifica CSS 2 per quanto riguarda la 
creazione di fogli di stile specifici per la 
stampa. Ora non ci sono più scuse per non 
convertirsi ai CSS! 



DATABASE 



MYSQL, Hibernate ed Eclipse: il trio 

Re 

pag. 28 

Oggi grazie a strumenti open source, è pos- 
sibile implementare soluzioni software 
estremamente efficienti e funzionali in 
tempi e costi nemmeno immaginabili fino a 
poco tempo fa 

Da SQL server al Web in un lampo . . 
pag. 34 

La nuova versione del database di Microsoft 
offre un supporto migliorato ad XML. In 
questo articolo vedremo come ottenere i dati 
direttamente in questo formato e come 
trasformarli grazie adXSLT 

SQL server 20005 service broker 

pag. 44 

Si tratta di una delle funzionalità più 
innovative nella nuova versione del DB 
di Microsoft. Implementa un sistema di 
messagistica basata su code, fra server. 
Vedremo come sfruttare questa 
caratteristica per le nostre applicazioni 



GRAFICA 



Menu grafici e a 
scomparsa! 

pag. 52 

Java si evolve, ed è ora 

possibile creare applicazioni 

che fanno uso di menu 

complessi, formati da una 

miscela di grafica, testo ed 

elementi multimediali. 

Inoltre si possono realizzare 

alcuni si m pati effetti 



MOBILE 



Integriamo le mappe sul pocket 
PC pag. 58 

In questo articolo sfrutteremo un Web 
service di Microsoft per visualizzare su 
una mappa la posizione degli indirizzi 
salvati sulla rubrica, con visual studio 
2005 molte operazioni risulteranno 
semplificate 



VISUAL BASIC 



Facciamo 
viaggiare i dati 
su Internet 

pag. 64 

Un server personalizzato che 
attende richieste 



SISTEMA 



Costruire uno skypebot pag. 50 

Se vi piace Skipe, p re pera te vi a 
diventarne amici intimi. In questo 
articolo scriveremo un programma che 
risponde ai messaggi mdi chat usando le 
API pubbliche di Skype e il linguaggio 
Ruby 

Un plugin per google desktop 
pag. 76 

Li chiamano gadget! i piccoli plugin che 
estendono la più nota applicazione per 



RUBRICHE 



Gli allegati di ioProgrammo 

// software in allegato alla rivista 



pag. 6 



Il libro di ioProgrammo pag. 7 

// contenuto del libro in allegato alla rivista 

News pag. 10 

Le più importanti novità del mondo 
della programmazione 

ioProgrammo by Example pag. 29 

4 problemi risolti con gli esempi di codice rapido 
da copiare e incollare per tutti i linguaggi 

Software pag. 106 

/ contenuti del CD allegato ad ioProgrammo. 
Corredati spesso di tutorial e guida all'uso 



J 



la ricerca di contenuti "Off-line". 
Impariamo a costruirne uno che ci 
mostra la lista dei "Task" da eseguire nel 
corso della giornata 

Alla scoperta del Pattern Observer 
pag. 82 

/ pattern sono "soluzioni" universali a 
problemi comuni. In questo numero 
affrontiamo il caso in cui un oggetto 
deve comunicare il suo stato ad altri. 
Come farlo in modo da garantire un 
codice facilmente espandibile? 

Creare applicazioni J2ME con 
Netbeans pag. 88 

Le applicazioni per dispositivi mobili su 
piattaforma J2ME rappresentano una 
percentuale elevata fra quelle sul 
mercato. Scopriamo come crearle in 
modo facile e veloce attraverso l'uso del 
mobility pack di netbeans 

Meno codice con il Namespace My 
pag. 92 

Lo spazio dei nomi "MY" permette di 
utilizzare in modo semplice, molte classi 
del .Net Framework consentendo 
un'interazione rapida con il computer, 
l'applicazione, le impostazioni e le 
risorse, rendendo più leggero il codice 

Applicazioni desktop in Java 6 
pag. 98 

Vediamo, attraverso esempi utili, le 
nuove funzionalità introdotte sullo 
sviluppo desktop da java 6 Mustang, che 
avvicinano di più Java al sistema 
operativo pur mantenendo sempre la 
sua caratteristica di portabilità 



QUALCHE CONSIGLIO UTILE 

I nostri articoli si sforzano di essere 
comprensibili a tutti coloro che ci 
seguono. Nel caso in cui abbiate 
difficoltà nel comprendere esattamente 
il senso di una spiegazione tecnica, è 
utile aprire il codice allegato all'articolo 
e seguire passo passo quanto viene 
spiegato tenendo d'occhio l'intero 
progetto. Spesso per questioni di spazio 
non possiamo inserire il codice nella 
sua interezza nel corpo dell'articolo. Ci 
limitiamo a inserire le parti necessarie 
alla stretta comprensione della tecnica. 



http://forum.ioprogrammo.it J 



Le versioni di ioProgrammo 
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RIVISTA + CD-ROM 

in edicola 



soopn » CODICE DI 

WINDOWS (o quasi) 

Prova Subito REACTOS il clone OpenSource 
di Windows e studia il codice per imparare 
i segreti dei programmatori 



ReactOS è un progetto che 
da tempo fa parlare di se. 
L'intenzione era ed è quella 
di creare un sistema operati- 
vo completamente 
OpenSource con compatibi- 
lità binaria con gli eseguibili 
di Windows. Recentemente 
è stata rilasciata la Release 
Candidate 1 della versione 3 
che ha raggiunto una matu- 
rità tale da portare il pro- 
getto, finalmente, su un 
piano pratico. In realtà lo 
scopo degli sviluppatori di 
ReactOS non è semplice- 
mente quello di emulare il 



più noto fratello maggiore e 
di raggiungere la compatibi- 
lità binaria con gli eseguibi- 
li, piuttosto quello di conti- 
nuare ad innovare e diven- 
tare un progetto indipen- 
dente. 



Reagì 



Prodotti del mese 



Alfresco 1.2.1 

Il CMS secondo JSP 

Semplicità è la parola d'ordine per 
accedere alla logica operativa di 
Alfresco, un innovativo sistema di 
content management che sta 
riscontrando un certo successo 
presso gli sviluppatori di tutto il 
mondo. Padre di Alfresco è John 
Newton, un nome che tra i "consu- 
matori" di CMS dovrebbe suscitare 
una certa reazione, poiché stiamo 
parlando del cofondatore di 
Documentum, tra i primissimi siste- 
mi di content management che già 
negli anni '90 spopolava presso la 
nicchia degli addetti ai lavori. A 
distanza di tre lustri, le cose sono 
cambiate anche nel mondo CMS, 
dove, il concetto di portale come 
spazio virtuale in cui ospitare con- 
tenuti dalla natura dinamica si è 
consolidato, e Alfresco ha saputo 
mantenere il passo con i tempi 
rimanendo uno dei più completi 
CMS del Web. 

[pag.107] 
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DotNetNuke 4.3.0 

Un frani ework per la costruzione 
di CMS 

Era nato come un semplice 
CMS ma nel tempo si è evoluto 
in modo rapidissimo ed è 
diventato un CMS strutturato 
in modo piramidale. Chi vuole 
può installarlo come semplice 
sistema di Document 
Management, ed in questo 
senso potrà sfruttare le 
funzioni esposte e non sono 
certamente poche. Il layout è 
molto personalizzabile, 
moduli sono molti e facilmente 
integrati. Coloro i quali invece 
necessitano di una maggiore 
personalizzazione possono 
pensare di mettere le mani 
direttamente nei sorgenti. 
Addirittura esiste uno starter 
kit per Microsoft Visual Studio 
2005. Si tratta di un prodotto 
decisamente maturo ed 
affidabile 

[pag.106] 
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Drupal 4.7.2 

La nuova versione della 
piattaforma per bloggers 

Un blog è un contenitore singolo 
di informazioni. Una piattaforma 
per bloggers è un sistema che in- 
clude in se più di un blog. Esempi 
concreti possono essere Splender, 
o Bloggers. Drupal è una piattafor- 
ma per bloggers scritta in PHP estre- 
mamente efficiente. Le sue carat- 
teristiche più interessanti sono 
quella della modularità e della fles- 
sibilità del layout. Dal punto di vi- 
sta del programmatore è utile sa- 
pere che Drupal espone un intero 
framework per la costruzione dei 
moduli. Se avrete occasione di da- 
re uno sguardo ai sorgenti, e agli 
esempi vi accorgerete che il fra- 
mework in questione è concepito 
in maniera assolutamente solida 
ed è stato progettato in maniera 
estremamente efficace. Espande- 
re Drupal non richiede particolari 
sforzi nello sviluppo 

[pag.107] 
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Eri- 



Wordpress 



Il primo blog! 

All'inizio c'era PHPNuke, poi 
sono arrivati Xoom e gli altri, e il 
primo a seguire il modello 
"Blog" che ormai conosciamo 
così bene è stato probabilmente 
Wordpress. Si tratta di un siste- 
ma molto semplice e veloce da 
utilizzare, ma allo stesso tempo 
anche molto completo ed effica- 
ce. Se non volete incorrere in 
inutili complicazioni, è lo stru- 
mento che fa per voi. Wordpress 
è leggero ma dispone di tutte le 
funzionalità tipiche di un CMS di 
grande levatura. Inoltre senza 
troppi sforzi è possibile far 
diventare Wordpress un multi- 
blog in cui gli spazi di molti 
utenti possono condensarsi in un 
unico centro. In definitiva si 
tratta di un prodotto affidabile, 
espandibile e che gode di una 
community di supporto impor- 
tante alla quale potrete sempre 
rivolgervi [pa g. 10 7] 
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I contenuti del libro 



Lavorare con Active Directory 



Chi non conosce il concetto di Directory? Una 
directory è un catalogo strutturato di 
informazioni. Nel caso più comune in una 
directory sono contenute le informazioni relative ai 
file che popolano il nostro disco rigido. Ma cosa 
succederebbe se esistessero Directory che 
contengono informazioni maggiormente strutturate? 
ad esempio l'elenco delle stampanti della nostra rete, 
o le generalità anagrafiche dei dipendenti 
dell'azienda, o la descrizione di un prodotto o 
qualunque altro tipo di informazione strutturata? Tutti 
i client della rete potrebbero accedere a queste 
informazioni snellendo molto il lavoro 
dell'amministratore. E' quello che si prefigge di fare il 
servizio di "Active Directory". In questo libro 
imparerete cosa deve fare un buon amministratore di 
rete per sviluppare un network efficiente e funzionale. 



LE CONOSCENZE INDISPENSABILI 
PER DIVENTARE AMMINISTRATORE 
DI RETE IN TECNOLOGIA WINDOWS 

• Introduzione ad Active Directory 

• Domini di Windows e concetti base 

• Ldap e i client degli utenti 

• Esempi pratici 



http://www.ioprogrammo.it 



Agosto 2006/7 ► 



I contenuti multimediali 



GLI ALLEGATI DI IOPROGRAMMO 



T Office Application 



Word, Excel, Outlook, Info- 
Path e gli altri programmi 
della famiglia Office costituisco- 
no, probabilmente, il set di appli- 
cazioni più usate di tutti i tempi e 
in qualunque ambito. Allora per- 
chè non sviluppare personalizza- 
zioni che consentono di integrare 
le vostre applicazioni direttamente 
all'interno di Office? Ad esempio, 
piuttosto che utilizzare un appli- 
cativo separato da Excel per recu- 
perare la lista dei fornitori, è pos- 
sibile fare in modo che Excel si 
connetta a SQL Server, recuperi i 
dati, li elabori e li mostri in output 
sullo stesso Excel. Così come si 
può redigere un contratto con Word 
creando un'applicazione che lo 



elabori automaticamente a parti- 
re da una raccolta di leggi 
preesistenti, e così via. Visual Stu- 
dio 2005 Tools for Office System 
(VSTO) è un ambiente che esten- 
de Visual Studio 2005 e permette 
di sviluppare applicazioni inte- 
grate all'interno di Office. Grazie a 
VSTO, sviluppare un'applicazio- 
ne che giri nel contesto di Word 
piuttosto che di Excel diventa sem- 
plice così come sviluppare un'ap- 
plicazione .NET tradizionale. La 
tecnica è innovativa e rivoluzio- 
naria. Seguendo gli MSDN Web- 
cast di questo mese, noterete quan- 
to possa essere utile e semplice 
usare Visual Studio 2005 Tools for 
Office System . 



I VIDEOCORSI PER PROGRAMMARE SERIE 

ffWEBCAST 

^UFFICIALI MICROSOFT 




msdn 



Introduzione a Visual Studio 
2005 Tools for Office System 

Funzionalità avanzate e deployment 
di applicazioni sviluppate con 
VSTO 2005 

Action Pane, controlli e Smart Tag 

Supporto per Outlook e InfoPath 



INFORMAZIONI SU MSDN WEBCAST 

http://www.microsoft.it/msdn/webcast_msdn 
http://forum.ioprogrammo.it 



FAQ 



Cosa sono i Webcast MSDN? 

MSDN propone agli sviluppatori una serie di eventi gratui- 
ti online e interattivi, che approfondiscono le principali 
tematiche relative allo sviluppo di applicazioni su tecnolo- 
gia Microsoft. Questa serie di "corsi" sono noti con il 
nome di Webcast MSDN. 

Come è composto tipicamente 
un Webcast? 

Normalmente viene presentata una serie di slide commen- 
tate da un esperto di tecnologie Microsoft. A supporto 
di queste presentazioni spesso vengono realizzate 
delle demo in presa diretta che mostrano dal vivo come 
usare le tecnologie oggetto del Webcast 

Come mai nei webcast allegati 
alla rivista si parla di chat e 
di altri strumenti interattivi? 

La natura dei Webcast è quella di essere seguiti online e in 
tempo reale. Durante queste presentazioni in diretta ven- 
gono utilizzati strumenti molto simili a quelli della forma- 
zione a distanza. E' possibile porre domande in presa diret- 
ta al relatore oppure partecipare ai sondaggi che vengono 
proposti. In questo modo gli sviluppatori possono aggior- 
narsi e approfondire i temi di loro interesse con maggiore 
efficacia. I Webcast riprodotti nel CD di ioProgrammo, pur 
non perdendo nessun contenuto informativo, per la natura 



asincrona del supporto non possono godere dell'interazione 
diretta con il relatore. 

Come mai trovo i Webcast 
su ioProgrammo 

Come sempre ioProgrammo cerca di fornire un servizio ai 
programmatori italiani. Abbiamo pensato che poter usufruire 
dei Webcast MSDN direttamente da un CD rappresentasse un 
ottimo modo di formarsi comodamente a casa e nei tempi desi- 
derati. Lo scopo tanto di ioProgrammo, quanto di Microsoft è 
infatti quello di supportare la comunità dei programmatori ita- 
liani con la più ampia gamma di strumenti di formazione e 
aggiornamento. 

Su ioProgrammo troverò 
tutti Webcast MSDN? 

Ne troverai sicuramente una buona parte. Direttamente sul 
sito MSDN potrai consultare il calendario dei prossimi 
webcast a cui iscriverti per seguirli in diretta oppure con- 
sultare l'archivio delle registrazioni di quelli già realizzati. 
L'indirizzo per saperne di più è 

www.microsoft.it/msdn/webcast msdn, segnalo nel tuo 
bookmark, non può mancare! 

L'iniziativa sarà ripetuta sui prossimi 
numeri? 

Sicuramente sì, alla prossima. 
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IL CODICE DELLA SFIDA 

elio ed intelligente il torneo di 
programmazione che si è tenuto 
a Melbourne in un locale chiamato 
Loop Bar. A sfidarsi sono state ben 
14 Crew di programmatori. 
L'oggetto della sfida era: " chi scri- 
verà in 10 minuti il miglior codice 
per il recupero di un'immagine dan- 
neggiata". E mentre le Crew si sfida- 
vano sul filo di patch, ottimizzazioni 
e ricompilazioni, il codice scorreva 
su un megaschermo sotto la vista di 
tutti.A far da sottofondo alla com- 
petizione, la musica dei Simulus e 
dei VS Chorus Crew. In molti hanno 
definito l'evento come emozionan- 
te. Ha vinto il team di Toasted 
Monkeys che ha risolto il quesito in 
5 minuti e 40 secondi. Dimostrando 
che la programmazione può anch 
essere uno Show! 



RILASCIATO OPEN 
WATCOM 1.5 

' stato per lungo tempo uno dei 
compilatori maggiormente perfor- 
manti disponibili sul mercato. Ad og- 
gi rimane l'unico a poter creare in C o 
in Fortran codice eseguibile per Win- 
dows 3.1 ed MS-DOS. Le novità in- 
trodotte riguardano l'introduzione 
dello standard ISO/IEC TR 24731 con 
la sostituzione delle non sicure strcpyO, 
strcat(), strncpyO e strncat(), con le 
più nuove strcpy_s(), strcat_s(), 
strncpy_s() e strncat_s(), create da Mi- 
crosoft. Altre modifiche minori sono 
state introdotte nel compilatore, tut- 
tavia a sorprendere non è tanto la ca- 
pacità di Open Watcom di continuare 
a innalzare il suo tasso tecnologico, 
quanto la sua longevità. Se è vero che 
I sistemi operativi supportati da que- 
sto compilatore sono scomparsi ormai 
da tempo, è difficile spiegarsi chi sia- 
no i reali utilizzatori di questo compi- 
latore. Eppure, per caratteristiche tec- 
niche, per la sua disponibilità in for- 
mato Open Source, per le sue spicca- 
te propensioni didattiche, per il rico- 
prire una nicchia evidentemente atti- 
va. Open Watcom riesce ancora a tener 
bene il mercato, e persino ad aggior- 
narsi con nuove versioni. 



ARRIVA WINDOWS COMPUTE 
CLUSTER SERVER 2003 



Microsoft 



mancava 



^^software in grado di esegui- 
re operazioni parallele High- 
Performance. Oggi la lacuna è 
stata colmata, è recente infatti 
l'annuncio del rilascio della ver- 
sione RTM (release to manufactu- 
ring) di Windows Compute 
Cluster Server 2003. Il prodotto 
sarà disponibile già dal mese di 
Agosto 2006. Gli ambiti applicati- 
vi sono I più disparati: dall'inge- 
gneria, alla ricerca medica, all'e- 
splorazione, la dove fino ad ora 
Unix deteneva un mercato asso- 
lutamente senza concorrenza. 
Non a caso fra I primi clienti 
annoveriamo il CASPUR, consor- 
zio italiano interuniversitario per 



le applicazioni di supercalcolo per 
università e ricerca. "La tecnolo- 
gia HPC ha la sorprendente capa- 
cità di allargare gli orizzonti del- 
l'ingegneria, della ricerca medica, 
dell'esplorazione e di altri impor- 
tanti ambiti che finora sono stati 
troppo onerosi e complessi da 
utilizzare e gestire efficacemen- 
te" ha affermato Bob Muglia, 
Senior Vice President Server and 
Tools Business di Microsoft. 
"Microsoft sta cercando di intro- 
durre in modo significativo la 
tencologia HPC nel mercato, for- 
nendo a dipartimenti e divisioni 
dell'industria e del settore pub- 
blico I vantaggi in termini di 
costi, semplicità d'uso, e di sup- 



ZIO BILL ADDIO! 



Doveva arrivare anche 
il giorno in cui il buon 
vecchio Bill Gates abban- 
donava la Microsoft, azien- 
da da lui creata quasi dal 
nulla, per dedicarsi alla be- 
neficienza. E' quel giorno 
è previsto per l'anno 2008. 
A dichiararlo è stato lo stes- 
so Bill Gates che ha an- 
nunciato di voler diminui- 
re il suo impegno in Mi- 
crosoft, riducendolo a quel- 
lo di un consulente tecnico, 
per dedicarsi invece a tem- 
po pieno alla "Bill e Melin- 
da Gates Foundation", un'or- 
ganizzazione con scopi di 
beneficienza fondata dallo 
stesso Bill Gates e piutto- 
sto conosciuta in America. 
Gates ha spiegato di esse- 
re pienamente soddisfat- 
to del proprio lavoro e di 
avere raggiunto traguardi 
tali sul piano economico e 
personale da sentirsi in do- 
vere di restituire quanto la 



vita gli ha dato, a coloro che 
ne hanno più bisogno. A 
prendere il posto di Chief 
Software Architect che già 
fu di Bill Gates sarà Ray Oz- 
zie. Craig Mundie che as- 
sumerà invece il ruolo di 



Chief Research and Stra- 
tegy Officer. Nessuno scos- 
sone alla valutazione in bor- 
sa dell'azienda di Redmond 
si è verificato in seguito a 
questo pur importante an- 
nuncio. 
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porto ei partner tipici della piattafor- 
ma Windows Server. Il nostro obietti- 
vo è far diventare la tecnologia HPC 
una risorsa diffusa - così facile da uti- 
lizzare proprio come sono le stampan- 
ti oggi". 

Certamente l'ingresso di un colosso 
come Microsoft in un mercato in cui 
fino a ieri II leader indiscusso era Sun, 
apre nuovi scenari. Riuscirà la grande 
e potente Microsoft a convincere I 
centri di calcolo, le Università e I labo- 
ratori di eccellenza ad effettuare una 
migrazione delle loro piattaforme 
verso la tecnologia Windows Server? 
Certamente se l'operazione dovesse 
riuscire, la casa di Redmond asseste- 
rebbe un altro duro colpo alla concor- 
renza, confermandosi come società in 
grado di offrire tecnologia anche ad 
elevate prestazioni in qualunque set- 
tore dell'informatica moderna anche 
la dove le prestazioni costituiscono 
un requisito irrinunciabile. 



LE CREATIVE COMMOMS 
SBARCAMO SU OFFICE 



3 Sharp, un noto Solution 
Provider di Microsoft, 
realizzerà per conto del- 
l'azienda di Redmond un 
tool gratuito che consen- 
tirà a chi lo desidererà di 
inserire le Creative Com- 
mons Licence in un docu- 
mento realizzato con Mi- 
crosoft Office con un solo 
click del mouse. Il tool sarà 
reso disponibile sul sito di 
Office Online. 
La notizia è di quelle che 
scotta. Di fatto un'enorme 
quantità di documenti ven- 
gono oggi prodotti grazie 
alla suite di Microsoft e la 
possibilità di poter inseri- 
re facilmente il riferimen- 



to alla licenze Creative Com- 
mons rappresenta una svol- 
ta epocale nella diffusione 
della documentazione li- 
bera. 

Lawrence Lessig, giurista 
e promotore delle Creati- 
ve Commons si è dichia- 
rato entusiasta di questa 
collaborazione con Mi- 
crosoft che certamente por- 
terà il logo delle CC su mol- 
tissima documentazione. 
Apprezzamenti sono arri- 
vati anche dal Brasile, do- 
ve Gilberto Gill, ministro 
della cultura, intravede 
grandi possibilità da questa 
collaborazione fra imprese 
commerciali ed enti no pro- 



fit. Il tool di 3Sharp sarà 
presentato proprio in Bra- 
sile durante FiSummito 
ovvero l'incontro che an- 
nualmente chiama a rac- 
colta tutte le community 
ed I grandi esperti di "de- 
mocrazia digitale" per di- 
scutere di come questo no- 
stro mondo potrebbe evol- 
vere. A dir la verità non so- 
no in molti a credere alla 
bontà di Microsoft nel vo- 
ler concedere a Lessig que- 
sto "calumet della pace". 
Di fatto Lessig è testimone 
contro Microsoft nella cau- 
sa che impegna l'Antitrust 
contro Microsoft già da 
molti anni. 



CINQUE MILIONI 
DI OPEMSOLARIS 

E questo il traguardo raggiunto da OpenSo- 
laris in un anno di vita. I risultati ottenti da 
Sun da quando ha deciso di dare vita alla co- 
munità OpenSolaris scegliendo di utilizzare il 
modello di business OpenSource come stru- 
mento per fare breccia nel mercato sono ec- 
cezionali. Si contano circa 14.000 aderenti al- 
la community e ben 5.000.000 di utenti regi- 
strati. Nessun sistema operativo prodotto da 
Sun aveva mai raggiunto traguardi simili. "Da 
quando abbiamo rilasciato Solaris nella co- 
munità open source i nostri obiettivi di cre- 
scita annuale del business e della diffusione 
del sistema sono stati abbondantemente su- 
perati. Oltre l'85% delle società Fortune 500 
utilizza Solaris 10 in sviluppo o in produzio- 
ne", ha dichiarato Rich Green, Executive Vice 
President of Software di Sun Microsystems. 
"Questa crescita eccezionale è il risultato di- 
retto della nostra strategia: investire per rea- 
lizzare il sistema operativo più avanzato, adot- 
tare un modello di business all'insegna del 
Software come Servizio e far crescere la co- 
munità degli sviluppatori Sun grazie al softwa- 
re gratuito e open source". Ed è recente l'an- 
nuncio della disponibilità di una nuova relea- 
se di Solaris 10, la 6/06. 



AJAX CONQUISTA JBOSS 



JBOSS è probabilmente l'applica- 
tion server più diffuso in ambito 
enterprise quando si tratta di servi- 
re aziende che necessitano di solu- 
zioni solide e affidabili. Da poco 
JBoss è stato acquisito da RedHat 
ed a distanza di pochissimo tempo 
ecco arrivare Seam, un framework 
per lo sviluppo di applicazioni Web 
in tecnologia Java con una spiccata 
propensione ad Ajax. Il concetto è 
semplice: esporre una serie di inter- 
facce, metodi, classi, proprietà, 
widget che orientino fortemente il 
programmatore a scrivere 
applicazioni che facciano 
uso della recente tecnolo- 
gia. Lo scopo è quello di 
mantenere la solidità delle 
applicazioni, ma anche 
quello di fornire all'utente 
un'interfaccia molto user 
friendly più vicina a quelle 
delle comuni interfacce 
standalone che non a quel- 
le che siamo abituati a 
vedere sul Web. Seam oltre 



che di Ajax farà uso anche delle 
nascenti Java Server Faces che rap- 
presentano una tecnologia ormai 
matura per la separazione dei con- 
tenuti dalla logica di business. Con 
questo passo JBoss mostra una par- 
ticolare attenzione a tutti gli ambi- 
ti della programmazione, garanten- 
do non solo l'ormai proverbiale 
affidabilità ma anche una certa 
facilità nello sviluppo di interfacce 
che siano in linea con l'orientamen- 
te sempre più moderno e user 
friendly a cui il web sta tendendo. 
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DATABASE A PROVA 



DI CRASH 



IMPARIAMO A PROGETTARE APPLICAZIONI CHE NON SMETTONO DI FUNZIONARE ANCHE 
IN CASO DI DANNI IRREPARABILI COME LA ROTTURA DI UN HARD DISK. ANALIZZEREMO 
ALCUNE TECNICHE DI FAILOVER INNOVATIVE, COME IL DB MIRRORING... 
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In questo articolo affronteremo un problema 
piuttosto complesso che non sempre può essere 
risolto con una soluzione univoca. Stiamo par- 
lando del "failover". Cos'è un "failover". La rispoOsta 
è semplice, è un metodo per garantire che la nostra 
architettura software continui a funzionare anche in 
presenza di errori irreversibili. L'esempio sarà chiari- 
ficatore: la nostra azienda dispone di un database 
centralizzato e di un certo numero di client che si 
connettono a questo db per fare una serie di opera- 
zioni. Poiché l'amministratore di sistema è decisa- 
mente un tipo sfortunato, l'hard disk centrale su cui 
è installato il database si rompe completamente! A 
questo punto entrano in gioco le tecniche di failover 
che dovrebbero consentire all'azienda di continuare 
a lavorare nonostante si sia verificato un problema 
così grave. 
Le possibili soluzioni sono: 

1) L'amministratore ha fatto un backup dei dati e 
può ripristinare tutto su un secondo hard disk. 
Gli svantaggi di questa soluzione sono evidenti. 
Prima di tutto il backup dei dati non potrà essere 
stato eseguito in tempo reale. Perciò al successivo 
ripristino potremmo avere perso qualche dato e 
se siamo abbastanza sfortunati il numero di ope- 
razioni compiute dopo l'ultimo backup e prima 
del crash sarà elevatissimo. In secondo luogo l'a- 
zienda non potrà utilizzare il db fino a che l'am- 
ministratore non avrà ripristinato il tutto, e que- 
sto tipicamente comporta un certo tempo d'atte- 
sa. 

2) L'amministratore è un tipo previdente e ha instal- 
lato il database in un cluster. Ora diciamo subito 
che questa soluzione è probabilmente una delle 
più interessanti, ma presenta qualche svantaggio. 
Un cluster è sostanzialmente un "contenitore" di 
servizi trasparente ai suoi consumer. Facciamo 
subito un esempio per chiarirci ogni dubbio. 
Abbiamo installato SQL Server su tre macchine 
differenti: Server_A, Server_B, Server_C. Su una 
quarta macchina "MyCluster" abbiamo installato 
Windows Server 2003. Possiamo riunire Server_A, 



Server_B. Server_C sotto l'unica macchina 
MyCluster, che funzionerà come una sorta di 
contenitore virtuale. Ogni volta che a MyCluster 
arriverà una richiesta per usufruire dei servizi di 
database, il cluster sceglierà quale dei suoi nodi è 
attualmente più scarico e dirotterà ad esso la 
richiesta. Infine Server_A, Server_B e Server_C 
saranno mantenuti sempre sincronizzati, di 
modo che l'utente abbia sempre la sensazione di 
utilizzare un unico DB. Questa soluzione ha molti 
vantaggi, ma anche alcuni svantaggi. Prima di 
tutto l'intero sistema deve soddisfare un certo 
numero di requisiti. Sulla macchina che fa da clu- 
ster devono essere installati Windows 2003, 
Microsoft Cluster Services, SQL Server 2005. MCS 
richiede anche Active Directory, quindi la mac- 
china in questione deve far parte di un dominio o 
esserne un controller. Bisogna dunque configu- 
rare MCS e di conseguenza SQL Server per lavo- 
rare all'interno del cluster. Tutto questo non com- 
porta una difficoltà elevatissima, ma comunque 
rappresenta un innalzamento della complessità 
dell'intero sistema. Infine bisogna dire che il livel- 
lo di glanuralità del Clustering è relativo all'intero 
server DB e non al singolo database. Tutte queste 
considerazioni, in questo contesto, vanno prese 
come un accenno al clustering, che è argomento 
decisamente complesso. Naturalmente lavoran- 
do in profondità scopriremmo che è possibile 
configurare il Cluster in modo molto efficiente. 
Ma non ne parleremo in questo articolo 

3) L'amministratore è un tipo in gamba. Ha scoper- 
to che in SQL Server 2005 è stata implementata 
una nuova funzionalità: il Database Mirroring. 
Questa tecnica è abbastanza semplice a livello 
logico. Si configurano tre macchine o almeno tre. 
Una prima macchina conterrà il Database prima- 
rio su cui si lavora costantemente. Una seconda 
macchina conterrà un'esatta copia del primo 
aggiornata in tempo reale. Sarà appunto il mirror 
del database centrale. Se succede qualcosa al 
database primario immediatamente il seconda- 
rio ne prenderà il posto. Il tempo di reazione è di 
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erica 3 secondi, e ovviamente non c'è perdita di 
dati, visto che i due server sono mantenuti sin- 
cronizzati in tempo reale costantemente. La terza 
macchina avrà funzioni di "Testimone". Questa 
macchina non è strettamente necessaria ai fini 
dell' allineamento dei dati, lo è alla fine della rile- 
vazione del failover. Funziona un po' come una 
sorta di arbitro fra i due server e comunica ai due 
partecipanti lo stato in cui ciascuno dei due si 
trova. In questo articolo illustreremo appunto 
questa architettura. 



TECNICHE DI BACKUP 
SEMPLICI 

Prima di avventurarci nella descrizione della 
nostra soluzione, sarà utile descrivere qualche 
tecnica base, che ci consente di ottenere un 
primo livello di sicurezza. Inizieremo ovviamen- 
te, con il classico backup. Supponiamo dunque 
di avere un database chiamato 
"ioProgrammo_DB" su un'istanza di SQL Server 
presente sulla macchina 192.168.1.3 e di volerne 
effettuare il backup. In scenari di produzione è 
abbastanza improbabile che il sistemista lavori 
direttamente sul server, piuttosto lavorerà su una 
macchina client che contiene un'installazione di 
SQL Server Management Studio. E' esattamente 
il nostro scenario. La nostra macchina client sarà 
il 192.168.1.2. Utilizzeremo questa macchina per 
connetterci al primo server ed effettuare un 
backup del database ioprogrammo_db in esso 
contenuto. Dalla nostra macchina 192.168.1.2 in 
SQL Server Management Studio, in modalità 
SQLCmd diamo il seguente comando 



:Connect tcp:192. 168.1. 3\SERVERA -U sa -P 



password 



Backup database ioProgrammo_db to DISK = 

'C:\Backup\ioProgrammo.bak' with INIT 



GO 




Fig. 1: Scenario di SQL Server Management Studio 
durante l'esecuzione del comando di Backup 




MODALITÀ SQLCMD 



SQL Server 2005, durante il setup, 
provvedere ad installare una serie 
di utility, alcune delle quali anche 
utilizzabili a linea di comando. Fra 
le tante una interessante è 
SQLCmd.exe che consente di 
connettersi a database remoti per 
eseguire su di essi operazioni 
direttamente da una Shell. 
L'utilizzo è semplice 

SQLcmd -S tcp:indirizzohost\ServerA 

-U sa -P password 

A questo punto è possibile inserire 
comandi locali al server 
selezionato, oppure usare delle 
macro predefinite in SQLCmd. Ad 
esempio: 

1> :serverlist 

nel nostro caso restituirà 

Server: 

A-K1C7EXUYUWI6\SERVERA 

A-K1C7EXUYUWI6\SERVERB 

ADOMANICO 

DBAMM 

INTRANET 

JACOXP 



Ovvero l'elenco dei Server SQL 
presenti nella rete locale. In SQL 
Server managent studio è possibile 
abilitare una modalità ristretta di 
SQLCmd che ci consente di inviare 
comandi remoti ad una macchina 
direttamente dall'editor di Query. 
Per farlo è necessario abilitare il 
pulsantino SQLCmd come vi 
mostriamo nella figura seguente 
[immagine due.png]. 
In questa modalità i comandi 
supportati da SQLcmd sono i 
seguenti: 

[:]go [count] 
!! <command> 
:exit(statement) 



:Quit 



:r <filename> 



:setvar <var> <value> 



:connect server[\instance] [-1 

login_timeout] [-U user [-P 
password]] 



:on error [ignore|exit] 



L 



: error <filename>|stderr|stdout 
:out <filename>|stderr|stdout 

Nel nostro articolo utilizziamo 
spesso il comando xonnect che 
serve appunto a connettersi ad una 
macchina remota. 



Il restore del database appena creato può avveni- 
re con il seguente comando: 



:Connect tcp:192. 168.1. 3\SERVERA -U sa -P 



password 



RESTORE DATABASE ioprogrammo_db FROM DISK = 
'C:\backup\ioprogrammo.bak' 
WITH MOVE 'ioprogrammo_db' TO 

'C:\ServerA\ioprogrammo_db.mdf, 
MOVE 'ioprogrammo_db_log' TO 

'C:\ServerA\ioprogrammo_db_log.ldf, 
NORECOVERY 

L'opzione MOVE fa si che i database in questione 
vengano "Spostati" nella directory specificata. 




LBACK E ROLLFORWARD 



In ogni momento SQL Server 
mantiene un log delle 
transazioni effettuate. In 
condizioni di ripristino di un DB è 
possibile tentare di ripristinare 
l'ultima transazione ed in questo 



caso si parla di RolIForward, 
oppure tentare di tornare 
indietro allo stato precedente 
all'ultima transazione eseguita, 
ed in questo caso si parla di 
RollBack 
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L'opzione NORECOVERY fa in modo che non 
venga eseguito il ROLLBACK delle transazioni ed 
abilita il conseguente ROLLFORWARD. 
Utilizzando queste tecniche è possibile eseguire 
un backup periodico dei database. In casi estre- 
mi e non volendo interagire con lo scheduler di 
SQL Server 2005 si può anche utilizzare SQLCmd 
in congiunzione allo scheduler di sistema per 
eseguire backup periodici dei database. 



DATABASE MIRRORING 

Abbiamo già accennato all'architettura prevista dal 
database mirroring. Entriamo nel particolare e cer- 
chiamo di capire esattamente qual è il flusso delle 
operazioni che viene eseguito in presenza di una 
configurazione come quella accennata 

• Un client invia una richiesta di transazione al ser- 
ver principale di SQL Server 2005 

• Il principale trascrive la richiesta di transazione 
nel file di log 

• Il file di log viene inviato al server secondario o 
mirror 

• Il server mirror esegue la transazione, valida il log 
e restituisce un OK al server principale 

• Quando il server principale riceve l'OK esegue la 
transazione e invia un messaggio di conferma al 
client 



lo 



Legenda 

Server principale 

Server mirror 



Cronologi 

Server di control 

del mlrronng 



t rollo 



Scenario 2 

Cronologia 

Server di controllo 

del rmrroring 



Partner A Partner E 




Partner A Partner B 

Server di controllo 
del mirroring 



SU 

Partner_A Partner_B 




La sessione dispone di un 
quorum completa, con 
Partner_A come server 
principale e Partner_B 
come server mirror. 



Partner_A perde il quorum 
e viene eseguito il failover 
automatico della sessione 

su Partner_B r che è II 
nuovo server principale. 



Anche Partner_B e II server 
di controllo del mirroring 
pendono il quorum e il 
database viene portato 
non In linea- 



Partner_A si neon nette al 
server di controllo del 
mirroring, che comunica 
che non è in grado di riportare 
il database in linea. Il database 
non è ancora disponibile. 



IL 

Partner B 



La sessione dispone di un quorum 
completo, con Partner_A come 
server principale e Partner_B 
come server mirror. 



6à — é) 

Partner A Partner E 



Il server di controllo del mirroring 
perde il quorum, ma rimane un 
quorum partner- partner. 
Partner_A lascia il database In linea. 



1 server A e B perdono il quorum e 
il database viene portato non in linea. 



Partner_A Partner_B 



Partner fi, Partner 9 
Server di controllo 

del mirroring 

Partner A Partner B 



Partner_A e II server di controllo del 
mirroring riottengono il quorum e 
il database toma in linea. 



Partner_B si ricon nette alla 
sessione e porta in linea il 
database principale corrente- 



là roD 

Partner_A Partner_B 



Non abbiamo detto ancora niente a proposito del 
ruolo del server di controllo del mirroring. In effetti 
la presenza di questo componente è opzionale, tut- 
tavia la presenza di "witness" o "testimone" rende 
automatico il failover. 

Il server di controllo non interagisce nello scambio 
dati e non contiene nessun database. Il suo ruolo è 
esclusivamente quello di controllare che ad un dato 
momento esista un "Quorum" di server sufficienti a 
tenere in linea almeno un database come principa- 
le. Nella figura seguente viene illustrato il diagram- 
ma di funzionamento del mirroring in due tipici 
sceari di failover 



DALLA TEORIA 
ALLA PRATICA 

In condizioni standard il "Database mirroring" 
non è disponibile su Sql Server, deve essere reso 
disponibile abilitando il Flag di traccia 1400. Per 
farlo è necessario eseguire i seguenti passi 

1) Aprite il "SQL Server Configuration Manager" 
e agite con il tasto destro del mouse sul nome 
che rappresenta l'istanza che desiderate con- 
figurare 



l J ^ ^ 


ocale) 
2005 


Nome 


| Stato 


z®5QL Server FullText Search (5QLEXPRE55) 


In esecuzione 


. jSQL Server Browser 


Avvia 

Interrompi 

Sospendi 

Riprendi 

Riavvia 


Interrotto 


■dJ.l.UliUM 


? 







2) Portatevi nella tabsheet "Avanzate" e aggiun- 
gete il parametro -T 1400 



jSQL Server FyliText Search (SQLEXPPESS) 
JjSQl Server SQLEXPRESS) 
jg)SQLSjr< 



In esecuzione 



Automatico NT AUTr 

Automatico NT AUTh 

nlAwio, Sistema... NT AUTr 



Accesso Servizio Avanzate 



c^F'ragrarnm^Microsoft SQL Serve 



Esecuzione in sistema operativo a No 
| IP istanza MSSQlT 



I Livello Service Pack 






e suggerir 



Parametri di 

Pai ametri utilizzati da SOL Server all'avvio dei servizio 






-- 



Server'iMSSQL • i 'i M5SQl.\D AT A\m«=ster . mdf ; -ec : 'i.Prciqrarfimii.lvìic rasoi 
Sei :ei \MSS0L. ''ir-'SSd'.i-'JGÌ.EF POPLOG.-ic.'.fi ogi amim\Mio o- ol I ■ 
Server\MSSQL . liMSSQL\DATA\mastlog.ldf :;-T 1400 



Fig. 2: Schema di funzionamento del mirroring in due condizioni tipiche 



A questo punto riawiate il servizio 
Per comodità creiamo un nuovo database iopro- 
grammo_db che contenga la tabella redazione. 
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Facciamolo direttamente da SQL Studio 
Manager, agendo tramite il pulsante destro del 
mouse su "Nuovo Database" 



E aggiungiamo qualche campo 




E attribuendogli un nome opportuno nella 
schermata che segue 




Creiamo anche una tabella agendo con il pulsan- 
te destro del mouse su "Nuova Tabella" 



1!HH 



File Modifica Strumenti Fij 

4 Nuova query ù S S S Q SH 



\È T 




l JACOXP\5QLEXPRESS (SQI '-ver 9.0.2047 - sa) 
J A-K1C7EXUYUVV SEI E ì 1QL Server 9.0.13? 
) l^ Database 

+ _i Database sterri; 

+ ^J Snapshot database 

- J ioProgrannnno_db 

(B □ Diagrammi database 




+ _| Service- Bi o! ei 

E0 □ Archivio 

[3 L^ Protezione 

~j| ReportServertSERVERA 

J ReportServer$SERVERATempDB 

13 □ Protezione 

13 □ Oggetti sei ver 

E) □ Replica 

+ _j Gestione 







■ j a ù'. _:.-■: i À 








» 8 X labelo-dlM.Hible I MlfJO^jQlLU. ■ 


QtyuefY].** 1 HKcdaqo - X 1 




Hrjira infoia l.yj J ti ì'i 


AamtttHU 


[INI 
Hfl. 

OS 


r1.n.:tH7 -.i) 


► lunapj&n mxh 


a 


. i«w M.U. |W 




M 
B 


E 



Infine aggiungiamo qualche dato alla tabella 





Progetto Progetf ione quei menti lesti 


Comunità ? 




icà ta Là i^dbf P ti È* fé :S\ 


■ ! s » tail a 


- ? x ! 


/tabella - dbo.Table_l Tabella - dbo.Table_l | 




ED Redattore Nome 


Cognome 


(SQL Server 9.0.2047 -sa) 
RVERA (SQL Server 9.0.13? 

sterna 
sbase 
db 
database 

5 di sistema 
able 1 




NULI 


Fabio 


Farnesi 




MJLL 


Gianfranco 


Forlino 




NULI 


Raffaele 


Del Monaco 




MAL 


Domenico 


Fingitore 


►* 


WSk 


NULI 


NULI 





Verifichiamo anche che la protezione delle transa- 
zioni sia in modalità FULL 

A questo punto eseguiamo il backup del database, 
come abbiamo imparato a fare tramite SQLCmd, 
oppure tramite SQL Management Studio, agendo 
con il pulsande destro del mouse su 
"Attvità/ Backup". Tramite SQLCmd il comando da 
impartire è il seguente 

:Connect tep: 192.168.1. 3\SERVERA -U sa -P password 
Backup database ioProgrammo_db to DISK = 

'C:\Backup\ioProgrammo.bak' with INIT 
GO 

E provvediamo a ripristinare lo stesso database 
su una seconda istanza che sarà quella che utiliz- 
zermo come "Mirror" 



:Connect tcp:192. 168.1. 3\SERVERB -U sa -P 



password 



RESTORE DATABASE ioprogrammo_db FROM DISK = 

'C:\backup\ioprogrammo_db' 
WITH MOVE 'ioprogrammo_db' TO 

'C:\ServerB\ioprogrammo_db.mdf, 
MOVE 'ioprogrammo_db_log' TO 

'C:\ServerB\ioprogrammo_db_log.ldf', 
NORECOVERY 



CONFIGURIAMO 
L'ARCHITETTURA 
PER IL MIRRORING 

A questo punto configuriamo il mirroring. E' 
possibile farlo anche a linea di comando, ma noi 
utilizzermo una comoda procedura guidata di 
SQL Management Studio. Posizioniamoci dun- 
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Programmare con il compact framework 




que sul server principale e agiamo con il tasto 
destro sul database di cui vogliamo configurare il 
mirrroring, scegliendo l'opzione proprietà dal 
menù contestuale 









ld LA uataDase 








a L^t Database di sistema 




II___K_IEEXKKB_ltl 


a TlÀ Protezione 




■LttttttUUEE 


a LA Oggetti server 




■pmnhì 


3 LA Replica 






a LA Gestione 




^sISSISSKs 


3 B A-K1C7EXUYUWI6\SERVERA (SQL Server 9.0. 1 






B LA Database 






a □ Database di sistema 






a □ Snapshot database 






a LA Diag 


Nuovo database... 






a LA Tabe 


Nuova query 






a LA Viste 
a LA Sinoi 

a La Prog 

a □ Serv 
a L^ Arch 

a La prot« 

a [J Report5« 
a |J Report5< 


Crea script per database ► 






Attività ► 


Mi 


mi 


Rinomina 


Messaggi 


Elimina 


Connessione a tcp: 172 . 16. . 14' 


Aggiorna 


Elaborate L 6 p agi e per il di 
Elaborate .. j agine per il dati 


HhéìUìIIÌ^H 


EESTORE DATABASE ha elaborato 
Disconnessione da tcp: 172. 16. ( 


a LA Protezione 




H LJ Oggetti server 




a LA Replica 




E fta Gestione 




a LA Notification Services 




a g) SQL Server Agent 




-- I7EXL UWI6\SERVERB (SQL Server 9.0. 




3 LA Database 




a □ Database di sistema 





Nella finestra che segue scegliamo "Mirroring" e 
avviamo il wizard agendo sul tasto "Configura 
Protezione" 




OBI 



■e i iiBimru JH tUtoLoH ri iikkMU »h?ihm uhi la 
[in rnnAQMH» tn1kxnro.i rW srrjtt rf nmlinln rW isimring fuw il ramini aggira 
drilo 1W0 drfe iiiùnze òe\ \witt pftncpsif « del inveì rràu e cortfrolsre 1 latore* 



CirAgjrmiÌJi fin 



I rea rinutn i*i'iiI,wl*a dH #fwci if nmlinta jtai nwKnrvj? 



TD 



Procediamo lasciando le impostazioni di default 
fino alla dialog box che ci chiede quale sarà il server 
principale. In questa finestra l'unica nota importan- 
te riguarda la porta di configurazione dell'EndPoint. 
Le comunicazioni fra i vari EndPoint che compon- 
gono il sistema di mirroring avverranno infatti tra- 
mite una specifica porta TCP II Nome dell'EndPoint 
può essere uno qualunque. Per EndPoint si intende 
il canale di comunicazione che verrà utilizzato per lo 
scambio dati. 



Istanza server principale 

Specificale le informazioni sull'istanza del server e he espilava il database 
originariamente. 



[stanza ?er«et principale: 
!a-K1C7EXUYUVVI6\SERVERA 



Specificare le proprietà dell'endpoint tramite il quale l'istanze de! server principale accetterà le 
connessioni dalle Istanze dei server mirrar e del server di conti-olio del miiroring: 



Porta di attesa: 



Crittografi iati inviati tramite- uesto endpoint 



Mirroring 



NOTA: se le istanze del server principale, del server mirror o del server di 
controllo del mirroring sono sullo stesso server, i rispettivi endpoint 
devono utilizzare porte diverse. 



[ < Indietro J [ Avanti > J [ Annulla 



Rispondiamo "si" alla prima opzione, dato che il 
nostro intento è proprio quello di configurare 
una sistema con failover automatico 




Se durante l'operazione di 
ripristino di un database dovesse 
verificarsi una condizione 
d'errore è ancora possibile 
recuperare un certo numero di 
dati. In particolare SQL Server 
2005 consente l'operazione 
RESTORE 

COIMTIIMUE_AFTER_ERROR. In 
questo caso viene tentato un 



ripristino di tutti i dati possibili 
non coinvolti nell'errore. 
Se si esegue un'operazione di 
CONTINUE_AFTER_ERROR, al 
termine del ripristino si 
potrebbero ottenere dei 
database inconsistenti, in tal 
caso è opportuno controllare la 
validità del database con il 
comando DBCC CHECKDB. 



Configuriamo poi il server di mirror, avendo cura 
di utilizzare il pulsantino connetti, per fornire le 
nostre credenziali di autenticazione 




M_ ■« « ■OPU'.lJWSEJl'JFAa 
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Infine con la stessa logica nella finestra successiva 
configuriamo il server di controllo del mirroring. Se 
tutto è andato a buon fine otterremo una finestra 
simile alla seguente, e non ci resterà che avviare il 
mirroring attraverso l'apposito pulsantino 



AUTHORIZATION [sa] 




Diamo anche un'occhiata agli script che avrem- 
mo dovuto utilizzare per creare la configurazione 
dei vari endpoint se non avessimo voluto farlo 
con il wizard, ma tramite comandi 



:Connect tcp:192. 168.1. 3\SERVERA -U sa -P 



password 



/****** Oggetto: Endpoint [Mirroring] Data 

script: 06/14/2006 14:41:54 ******/ 



CREATE ENDPOINT [Mirroring] 



AUTHORIZATION [sa] 



STATE = STARTED 



AS TCP (LISTENER_PORT = 5022, 

LISTENER_IP 



ALL) 



FOR DATA_MIRRORING (ROLE = PARTNER, 
AUTHENTICATION = WINDOWS NEGOTIATE 
, ENCRYPTION = REQUIRED ALGORITHM RC4) 
:Connect tcp:192. 168.1. 3\SERVERA -U sa -P 



password 



/****** Oggetto: Endpoint [Mirroring] Data 

script: 06/14/2006 14:42:26 ******/ 



CREATE ENDPOINT [Mirroring] 



AUTHORIZATION [sa] 



STATE = STARTED 



AS TCP (LISTENER_PORT = 5023, 

LISTENER_IP 



ALL) 



FOR DATA_MIRRORING (ROLE = PARTNER, 
AUTHENTICATION = WINDOWS NEGOTIATE 
, ENCRYPTION = REQUIRED ALGORITHM RC4) 
:Connect tcp:192. 168.1. 2\WITNESS -U sa -P 



password 



/****** Oggetto: Endpoint [Mirroring] Data 

script: 06/14/2006 14:43:14 ******/ 



STATE = STARTED 



AS TCP (LISTENER_PORT = 5024, 

LISTENER_IP 



ALL) 



FOR DATA_MIRRORING (ROLE = WITNESS, 
AUTHENTICATION = WINDOWS NEGOTIATE 
ENCRYPTION = REQUIRED ALGORITHM RC4) 



Notate che in questo scenario test abbiamo uti- 
lizzato due istanze su un'unica macchina e la 
terza su una macchina separata. Questo perché 
l'articolo ha fini didattici, in fase di produzione 
potete tranquillamente utilizzare macchine 
separate. 

Notate anche che proprio perché le istanze erano 
sulla stessa macchina abbiamo usato porte sepa- 
rate per ciascuna istanza. 



ANCORA SU ROLLBACK 
E ROLLFORWARD 

Durante la fase di ripristino del database, con 
l'opzione rollforward, vi sarete sicuramente 
accorti che il database è completamente inu- 
tilizzabile. Molto probabilmente rimarrà in 
uno stato di perenne "Reovering". In un box 
all'interno di questo articolo abbiamo già 
spiegato che l'opzione Rollforward tenta di 
ripristinare il database interamente fino 
all'ultima transazione. Questo vuol dire che 
potrebbero esserci all'interno del db da recu- 
perare, delle transazioni che non sono state 
ancora sottoposte a Commit. Per tale motivo 
il Database rimane in un perenne stato di 
recovering fino a che non viene sottoposto ad 
una seguente operazione di RollBack. 



IVARE IL PROTOCOLLO TCP/IP 








Perché tutto funzioni 
correttamente dovete abilitare 
il protocollo TCP/IP nelle varie 
istanze dei server. Per farlo 



utilizzate il SQL Server 
Conf iguration Manager alla 
voce "Protocol" 




VER EXPRESS O STANDARD 



CREATE ENDPOINT [Mirroring] 



Il Mirroring non è supportato 
dalle versioni Express, quindi 
dovrete utilizzare versioni 
Standard, Enterprise o Developer. 
In teoria sarebbe possibile 
utilizzare la versione Express come 



Witness. Nella pratica abbiamo 
riscontrato non pochi problemi 
con questa soluzione. Per cui il 
nosto consiglio è quello di 
utilizzare sempre e comunque 
versioni superiori 
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E VERIFICA 
DELLA CONFIGURAZIONE 

Prima di tutto eseguiamo una verifica sem- 
plicissima. Diamo uno sguardo al nostro SQL 
Server Management Studio e selezionando il 
database ioProgrammo_db sul server princi- 
pale noteremo che viene evidenziato come: 
Principal Synchronized. Allo stesso modo 
diamo uno sguardo al mirror e notiamo che 
viene etichettato come Mirror, Synchronized/ 
Restoring. Il server mirror non è accessibile 
neanche in lettura. Un secondo test è ovvia- 
mente facilmente eseguibile creando in 
Visual Basic 2005 una semplice applicazione 
per la gestione del database appena creato. Vi 
risparmio la procedura guidata per la crea- 
zione del database. Ciò che conta è che la 
stringa di connessione deve essere 

Data Source= 192. 168. 1.3\SERVERA; Failover 

Partner=192.168.1.3\SERVERB;Initial 

Catalog = ioProgrammo_db;Persist Security 

Info=True;User ID=sa; Password = password 

Notate che abbamo settato un server di failo- 
ver immettendo le coordinate del nostro ser- 
ver di mirroring. 

Lanciamo l'applicazione e eseguiamo qual- 
che modifica sul database aggiungendo o 
rimuovendo i dati. 

Quando siamo ben soddisfatti stoppiamo 
Finstanza del server principal e magia delle 
magie noterete che tutto continua a funzio- 
nare normalmente, possiamo cancellare, 
modificare, inserire nuovi dati e F applicazio- 
ne non subirà nessuno scossone. Il server 
mirror in questo momento è stato promosso 
come principal. Riawiamo il principal e 
notiamo che ancora una volta i dati sono alli- 
neati. La condizione iniziale è stata ripristi- 
nata. Anche stoppando il witness tutto fun- 
ziona normalmente. 

L'unico problema che possiamo avere stop- 
pando il witness è che in caso i failover la pro- 



mozione del mirror a principal deve essere 
fatta manualmente. 



RIPRISTINO DEL 
DATABASE MASTER 

Quanto abbiamo fin qui detto è tutto bellissi- 
mo! E funziona alla perfezione. Ma che cosa 
succede se a danneggiarsi è il database 
master? Il Database Master, così come il 
model e il distribution non sono mirrorabili. 
Tutti sanno che il DB master contiene le 
informazioni sulla gestione degli utenti, sugli 
altri DB presenti e su ogni altra impostazione 
riguardante il funzionamento del server, 
quindi un suo mancato funzionamento pro- 
vocherebbe danni irreparabili. 
Ora, è anche vero che se abbiamo proceduto 
a mirrorare i DB che ci servono, anche il dan- 
neggiamento del master sul primario, sul 
secondario o sul Witness non provocherà 
gravi interruzioni di funzionamento, tuttavia 
illustriamo qualche procedura per ripristina- 
re/ricostruire un db Master danneggiato. 
Il primo passo, quello più semplice, è creare 
frequentemente un backup del master. 
Ormai abbiamo imparato come fare per com- 
piere tale operazione, perciò tutto quello che 
dobbiamo fare è scrivere una nuova query nel 
modo seguente: 



:Connect tcp:indirizzoip\istanza -U utente -P 



password 



Backup database master to DISK = 

'C:\Backup\master.bak' with INIT 




OM ARIDO DBCC CHECKDB 



GO 



In realtà avevamo già visto questo comando. 
Ve lo riproponiamo per sottolineare che è 
possibile effettuare un backup del master 
solo in modo "completo". 
In tutti gli altri casi è possibile utilizzare 
anche altre modalità, ad esempio quella "par- 
ziale 

A questo punto per ripristinare il Master è 
necessario 



Il comando in questione 
esegue una verifica 
approfondita dell'intero 
database per testarne la 
consistenza. In particolare, 
esegue un CHECK_ALLOC sul 
database per la verifica della 
corretta allocazione degli 
oggetti, un CHECK_TABLE per 
controllare la consistenza delle 



tabelle, controlla se ci sono 

messaggi nel service brocker e 

infine controlla la validità dei 

cataloghi. 

Il comando DBCC CHEKDB può 

utilizzare molti parametri. Un 

elenco completo è disponibile 

all'indirizzo 

http://msdn2.rn icrosoft.com/it- 

it/library/ms176064.aspx 



J 



1) Avviare un'istanza del server in modalità 
utente singolo. Ovvero digitando da una 
shell il seguente comando: 

sqlservr.exe - m -s 

<computer_name>$<instancename> 

2) Ripristinare il master come abbiamo fatto in 
precedenza con gli altri Database utilizzando 
una query di questo tipo 
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USE master 



GO 



RESTORE DATABASE master 



FROM DISK = 'C:\backup\master.bak' 



GO 



In questo caso notate che non abbiamo utilizzato 
l'opzione No Recovery. 

Se tutto andrà a buon fine il master verrà 
ripristinato, con la conseguenza che tutti i DB 
presenti al momento del suo danneggiamento 
verranno ugualmente ripristinati. 
Ovviamente il ripristino avverrà in maniera 
speculare ai dati salvati nell'ultimo backup. Se 
avete effettuato modifiche dopo l'ultimo 
backup queste non saranno ripristinate. 
Il miglior consiglio che possiamo darvi è quel- 
lo di effettuare un backup del master imme- 
diatamente dopo avere effettuato una modifi- 
ca. 



RICOSTRUZIONE 
DEL MASTER 

Se siete particolarmente sfortunati, è possibi- 
le che in seguito al danneggiamento del 
master SQL Server decida di non ripartire. In 
questo caso l'unico tentativo possibile da 
effettuare è quello della ricostruzione del 
master danneggiato. 

Prima di SQL Server 2005 esisteva un coman- 
do "Rebuildm" che ci avrebbe aiutato nelle 
nostre operazioni. Questo comando non è 
tuttavia più disponibile in questa versione, 
quindi bisogna ricorrere al setup.exe al quale 
dobbiamo fornire dei parametri per la sola 
ricostruzione del master. In particolare, dal 
supporto di installazione di SQL Server 2005 
utilizziamo il seguente comando 



setup.exe /qn INSTANCENAME=<InstanceName> 

REINSTALL=SQL_Engine REBUILDDATABASE=1 
SAPWD= < NewStrong Password > 

Il parametro 'qn' nasconde le finestre di dialo- 
go, mentre quello 'qb' consente di visualizzare 
finestre di dialogo e messaggi d'errore. In 
seguito alla ricostruzione del master verranno 
persi tutti gli eventuali Service Pack installati, 
quindi è opportuno ripetere un nuovo update. 



CONCLUSIONI 

Come detto in apertura di articolo, il cluste- 
ring rimane probabilmente il modo migliore 



per mettersi al riparo da eventuali problemi, 
tuttavia il DB mirroring ha alcuni vantaggi che 
lo rendono particolarmente interessante negli 
scenari più consueti, non ultimo quello di 
non comportare l'installazione di software 
aggiuntivo e quello di rispondere ad una 
gestione sufficientemente semplice. 
Nonostante abbiamo dedicato poche righe 
all'applicazione client che sfrutta il DB 
Mirroring, vi sarete già accorti che se queste 
tecniche vengono utilizzate in congiunzione 
al framework .NET 2.0 , risultano particolar- 
mente efficaci. Per un programmatore, sup- 
portare il DB mirroring si riduce ad aggiunge- 
re un parametro alla stringa di connessione. 
SQL Server 2005 supporta un numero eleva- 
tissimo di opzioni per il backup dei dati. 
Tuttavia il Backup semplice non mette al ripa- 
ro da eventuali crash fisici o assenza di con- 
nessioni. In tutti questi casi ci vien incontro il 
DB Mirroring. 

Nonostante gli elevati livelli di sicurezza di 
SQL Server 2005 e a prescidendo dalle tecni- 
che di recovering è importante ricordare che il 
primo passo da compiere per essere certi che 
i nostri dati siano al sicuro è il semplice 
backup, costante ed eseguito ad intervalli di 
tempo regolari, anche e soprattutto del db 
Master. Un problema può sempre accadere, 
ma l'importante è farsi trovare preparati! 



STATI DEL DATABASE 





In ogni momento un database 
può essere in uno dei seguenti 
stati: 

OnLine: E' lo stato classico. Il 
Database è in linea e pronto 
per essere usato 

Off line: Il database è stato 
portato non in linea e non è 
disponibile. E' un'operazione 
che deve essere compiuta 
dall'utente. Normalmente 
questo tipo di condizione è 
opportuna quando si vogliono 
spostare dei file da una 
locazione ad un'altra. Appena 
terminata l'operazione si può 
riportare il database in 
modalità OnLine 

Restoring: Si sta ripristinando 
un database da un backup 
Recovering: E' in corso il 
processo i recupero del db. 



' 



Recovery Pendi ng: si è 
verificato qualche errore 
durante il processo di 
recupero. Questa condizione 
non si modifica 
automaticamente ma richiede 
un qualche intervento manuale 
da parte dell'utente 

Suspect: C'è un problema sul 
database, probabilmente è 
danneggiato. Il Database non è 
disponibile e bisogna tentare 
un azione di recupero 

Emergency: Il Database viene 
posto in questa condizione 
dall'utente. In questo stato il 
database è in modalità utente 
singolo, può essere corretto o 
ripristinato ed è consentito 
l'accesso in modalità 
READ_ONLY, sola lettura, a 
coloro che hanno i privilegi di 
amministratori del database 
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STAMPA DI PAGINE 
WEB CON CSS 

TUTTE LE PRINCIPALI NOVITÀ INTRODOTTE DALLA SPECIFICA CSS 2 PER QUANTO RIGUARDA LA 
CREAZIONE DI FOGLI DI STILE SPECIFICI PER LA STAMPA. ORA NON CI SONO PROPRIO PIÙ SCUSE 
PER NON CONVERTIRSI Al CSS! 





MdM.UU.UMU.llim 
— Elementi di HTML, 
L -' Javascript, CSS 




Tempo di realizzazione 



e 



Ai primordi, il web era una semplice 
rete digitale costituita da documenti 
statici, il cui obiettivo era principal- 
mente quello di fornire informazioni su una 
molteplicità di argomenti. In seguito Internet 
ha subito una rapida espansione, crescendo 
vertiginosamente sotto l'incalzare di nuove e 
sempre più sofisticate esigenze: si è passati, 
infatti, dalle pagine web statiche a documenti 
in grado di interagire con server remoti per 
modificare dinamicamente i propri contenu- 
ti, fino a giungere alle moderne frontiere del- 
l'e-commerce e dell'e-banking, che inaugura- 
no una nuova era di servizi tecnologici alla 
portata di tutti. Questa rivoluzione, come è 
facile intuire, con il passare del tempo ha 
allargato sempre di più il divario tra program- 
matori e grafici, intendendo per i primi coloro 
che si occupano soprattutto delle logiche di 
funzionamento del sito, e per i secondi coloro 
che invece curano maggiormente Y organizza- 
zione e la presentazione dei contenuti. È evi- 
dente che ciò ha comportato una sempre cre- 
scente specializzazione delle due figure, e una 
maggiore caratterizzazione delle stesse, a dif- 
ferenza di ciò che avveniva nel passato quan- 
do spesso e volentieri i due ruoli tendevano a 
confondersi tra di loro. 



CSS: LI CONOSCIAMO? 

Alla luce di quanto sopra riportato, è evidente 
che al giorno d'oggi la realizzazione di un sito 
web compatibile con la maggior parte dei 
browser esistenti e conforme con gli attuali e 
soprattutto futuri standard qualitativi è un 
lavoro che richiede una grande attenzione, 
non soltanto per gli aspetti legati alla pro- 
grammazione dei contenuti, ma anche e 
soprattutto per quelli legati alla forma e alla 
presentazione delle informazioni. Prendiamo, 
ad esempio, i CSS (fogli di stile): credo che 
qualunque sviluppatore in ambito Internet 



sappia cosa sono, li sappia utilizzare più o 
meno bene all'interno di un sito web, e così 
via. Credo anche, tuttavìa, che ben difficil- 
mente uno sviluppatore alle prime armi, che 
magari ha poca esperienza di lavoro in ambi- 
to Internet, riesca a cogliere appieno le grandi 
opportunità che essi possono offrirgli. 
L'errore in cui più comunemente cade il web- 
master alle prime armi, infatti, è proprio quel- 
lo di tendere facilmente a privilegiare il "cosa 
devo fare" rispetto al "come lo devo fare", abo- 
lendo pressoché totalmente la fase di proget- 
tazione iniziale e adottando un modus ope- 
randi di stampo decisamente pragmatico, 
efficace però solo in apparenza. 
Il risultato sarà, con ogni probabilità, la realiz- 
zazione di un sito web che non rispetta i prin- 
cipali canoni della web-usability. Giova con- 
statare, a questo riguardo, come il famoso 
detto di Machiavelli "il fine giustifica i mezzi", 
tanto apprezzato nel mondo informatico 
attuale da divenirne la principale causa del 
declino qualitativo, in questo ambito più che 
in altri ha ormai fatto il suo tempo, spodesta- 
to dalla moderna esigenza di riconoscere il 
giusto spazio anche alla progettazione e alla 
corretta organizzazione dei contenuti, piutto- 
sto che al solo sviluppo delle logiche pro- 
grammatiche sottostanti. Ma ben lungi dal 
voler fare una crociata contro i cultori 
dell' "informatica facile", visto che non è sicu- 
ramente questo il momento più opportuno 
per farlo, ritorniamo alla domanda posta dal 
titolo del presente paragrafo: quanto in 
profondità conosciamo i CSS ? 
Per rispondere a questa domanda partiamo 
subito dall'analisi di un caso pratico, che a 
prima vista può apparire scontato, ma che 
nella realtà nasconde qualche piccola insidia: 
vogliamo stampare una pagina web senza 
includere nell'output il pulsante di stampa. 
Vogliamo anche applicare, nel caso del layout 
di stampa, una formattazione grafica dei con- 
tenuti diversa rispetto a quella adottata a 
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video. Lo studio di questo esempio affronterà 
un argomento annoso ed estremamente 
importante com'è, appunto, la gestione della 
stampa delle pagine web, e nello stesso tempo 
illustrerà le principali caratteristiche e il fun- 
zionamento di un attributo dei CSS tanto 
importante quanto sconosciuto e sottovaluta- 
to: il media. 



STAMPA: 

UN PRIMO ESEMPIO 

Javascript dispone della funzione print{), che 
consente di effettuare la stampa di un docu- 
mento web. Tale funzione rappresenta un 
metodo di Window, gerarchicamente il più 
elevato degli oggetti Javascript, e può essere 
utilizzata soltanto per stampare un documen- 
to web intero. L'idea, a questo punto, potreb- 
be essere: lavoro con 2 frame; uno che contie- 
ne il pulsante, l'altro che contiene il docu- 
mento web da stampare. Su pressione del pul- 
sante (evento onclick) deve essere invocata 
una funzione che stampa il frame dei conte- 
nuti. 



<center> 



stampa. 


_layer.html 






<html> 


<head> 


<meta 1 


ittp-equiv= 


= "Content-Type" 

content= 


"text/html"> 


<title>Esempio di 


stampa con frame< 


/title> 


<script> 


function stampaQ { 



primo. focus(); //sposta il 

cursore sul primo frame 

primo. print(); //stampa il primo 

frame 



} 



</script> 



</head> 



<frameset cols="50%,50%"> 



<noframes> 



Il tuo browser non supporta i frame 



</noframes> 



< frame src= "primo. htm l"name= "primo" > 
<frame 

src= "secondo, html "name= "secondo" > 



</frameset> 



</html> 



primo.html 



<html> 



<head> 



<meta http-equiv="Content 

Type"content="text/html"> 



</head> 



Questa è la pagina che 
deve essere stampata: 



il pulsante invece non compare 
in stampa 



</center> 



</body> 



</html> 



secondo.html 



<html> 



<head> 



<meta http-equiv="Content-Type" 

content="text/html"> 



</head> 



<body> 



<input type=button onclick="javascript: 
parent. stampaQ ;" value= "stampa" > 



</body> 



</html> 

La soluzione appena illustrata sicuramente 
funziona, qualcuno potrà però obiettare sul 
fatto che l'utilizzo dei frame, a tutt'oggi, è 
decisamente sconsigliato nella maggior parte 
dei casi, vista la grande quantità di inconve- 
nienti (ampiamente descritti nel riquadro a 
lato) che essi presentano. Il sistema migliore, 
infatti, è quello di sfruttare le grandi potenzia- 
lità dei CSS, che consentono di lavorare dina- 
micamente sui vari elementi costitutivi della 
pagina web organizzandoli in layer: per questi 
ultimi sono tra l'altro disponibili proprietà 
che consentono di specificare se un elemento 
è visibile o meno. L'idea, a questo punto, può 
essere quella di invocare, su pressione di un 
pulsante, una funzione Javascript che, prima 
di stampare la pagina, renda invisibile il layer 
con il pulsante stesso. 

<html> <head> 

<script language="JavaScript"> 

function stampa() 

{ 

area=document.getElementById 

('area_stampa').syl; 
area, visi bility="hidden"; 




Negli esempi di questo articolo 
sono stati usati due metodi per 
non far comparire un layer in 
fase di stampa: display:none e 
visibility:hidden. 
Ma qual è la differenza tra i due? 
In pratica, se si usa 
visibilityzhidden il layer coinvolto 
non verrà mostrato, ma ne sarà 



mantenuto ugualmente 
l'ingombro (quindi, è come se il 
layer venisse soltanto reso 
invisibile pur continuando a 
esistere fisicamente). Con 
display:none, invece, il layer 
viene proprio rimosso dall'output 
della pagina, e quindi non 
occuperà neppure spazio. 



<body> 
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self.printQ; //stampa se stessa 



} 



</script> 



</head> 



<body> Pagina di prova: questa riga deve 

comparire anche sulla stampa 
<div id = "area_stampa" 

style="position:absolute;top:100;left:100;"> 
<form> 
<input type="button" value="Stampa" 

onclick= "Javascript: stampa();"> 



</form> 



</div> 



</body> 



</html> 

Pur essendo una soluzione apprezzabile 
come base di partenza per la nostra analisi, 
tuttavìa è evidente che la funzione sopra 
riportata diverrebbe molto più complicata se 
volessimo gestire anche tutti i comportamen- 



ti e gli stili che ogni browser deve adottare in 
fase di stampa e successivamente alla stessa. 
Ma soprattutto il problema principale è che 
non siamo ancora riusciti a separare total- 
mente le logiche di gestione della stampa da 
quelle legate al normale layout a video (es. se 
stampo direttamente dal browser, la pagina 
includerà inesorabilmente anche il pulsante 
di stampa). 

Abbiamo sicuramente imboccato la strada 
giusta, tuttavia siamo ancora abbastanza lon- 
tani dall'obiettivo: e pensare che il problema, 
inizialmente, sembrava così banale ! 
Ebbene, a riprova del fatto che, come diceva il 
noto protagonista di tanti romanzi di Arthur 
Conan Doyle Sherlock Holmes "spesso siamo 
portati a ricercare lontano da noi la soluzione 
di un problema mentre non ci accorgiamo 
che ne abbiamo una molto più semplice a 
portata di mano", ecco che tutte le nostre dif- 
ficoltà svaniscono semplicemente dopo una 




TAMPARE CON DUE PAGINE DISTINTE 



Sfrutteremo il metodo 
innerHTML di un layer, la 
pagina da stampare sarà 
generata dinamicamente. 
Questo ci consente di evitare la 
creazione di due copie effettive 
della stessa pagina, diverse solo 
per pochi elementi, che 
renderebbe di difficile 
manutenzione la pagina stessa, 
con conseguenti possibili 
disallineamenti tra le due 
versioni. Agendo poi sul 
metodo print() della finestra 
creata, si awierà la stampa del 
documento. Ma se si volesse 
stampare la pagina senza 
visualizzare la finestra ? È 
possibile, ma bisogna ricorrere 
ad artifici particolari, per 
esempio impostando degli 
attributi di posizionamento 
della finestra volutamente 
esagerati rispetto alle 
coordinate del video, che 
quindi non ne permettono la 
visualizzazione. Un sistema, 
questo, molto fantasioso, ma 
che sicuramente non 
rappresenta una soluzione 
pulita ed elegante come'è 
quella che fa uso, invece, dei 
fogli di stile. 

Es. pratico di gestione della 
stampa con creazione di due 
versioni distinte della stessa 
pagina: 
stampa.html 



<html> 



finestra 



<head> 



fin.document.open(); 



<title>Esempio di 
stampa con 2 versioni distinte 
della stessa pagina</title> 
<link rel = "stylesheet" 
href="video.css"> 



fin.document.write(codice); 



fin.document.close(); 



// fin viene a 
contenere l'oggetto-finestra 
creato 



<script> 



function 

stampa_popup() { 
var codice = 
"<htmlxheadxtitle>Pagina di 
stampa</title>"; 
//il 
documento di stampa deve 
essere linkato al foglio di stile 
usato per la stampa 
codice + = 
"<link rel=\"stylesheet\" 
href=\"stampa.css\">"; 
codice + = 

"</head>"; 
codice + = 

"<body>"; 
codice + = 
document.getElementById('livello 
_da_stampare'). innerHTML; 
codice + = 
"</bodyx/html>"; 
var fin = 
window.open("", "stampa", "width 
= 500, height=400"); //apro la 



fin.print(); //invoco la 
funzione print()sulla finestra per 
chiamare la stampa 



fin.close(); 
//chiudo la finestra generata 
dinamicamente dopo la stampa 



} 



</script> 



</head> 



<body> 



<div id = "livello_da_stampare"> 



<b>Nel mezzo del cammin di 

nostra vita, mi ritrovai<br> 



per una selva oscura, chè 
la diritta via era smarrita. </b> 



<brxbr> 



<cite>Dante Alighieri</cite> 



</div> 



<brxbr> 



<input type=button 

value="Stampa" 
onclick="javascript: 
stampa_popup();"> 



</body> 



</html> 
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più attenta lettura delle caratteristiche di 
base della specifica CSS stessa. 
Evidentemente non serve quindi ricercare 
soluzioni fantasiose e complicate, basta sem- 
plicemente approfondire meglio lo studio 
degli strumenti (nel nostro caso i fogli di stile 
appunto) che già fanno parte della nostra 
"cassetta degli attrezzi". Ma in che modo i 
CSS ci vengono in aiuto ? 



CSS: L'ATTRIBUTO 
MEDIA 

In precedenza abbiamo avuto modo di 
accennare all'esistenza di un attributo dei 
CSS, il media: è ora venuto il momento di 
analizzarlo. 

Grazie a tale attributo siamo in grado di 
impostare un diverso foglio di stile a seconda 
del supporto sul quale intendiamo distribui- 
re la nostra pagina: questa opportunità, la cui 
utilità è maggiormente comprensibile se 
intendiamo gestire il layout di stampa di un 
documento, sarà importante, più in generale, 
anche per quei webmaster, particolarmente 
lungimiranti e attenti all'evoluzione di 
Internet, che desiderano fin da subito rende- 
re il proprio sito web compatibile con tutti i 
futuri mezzi di diffusione delle pagine 
(X)HTML. Nel futuro, infatti, i normali brow- 
ser potranno essere affiancati da palmari, 
cellulari, altri dispositivi e, perché no?, anche 
browser vocali per i disabili; Tutte tecnologie, 
queste, dotate di caratteristiche molto diffe- 
renti tra di loro in termini di gestione della 
memoria, ampiezza degli schermi, ecc., al 
punto da richiedere, quindi, specifiche di for- 
mattazione degli stili assai differenti le une 
dalle altre. Ma ritornando alla stampa, è 
necessario ribadire come l'organizzazione 
dei contenuti predisposta per la visualizza- 
zione a video non è immediatamente appli- 
cabile alla riproduzione su carta. La soluzio- 
ne, adottata da alcuni webmaster, di realizza- 
re due versioni distinte della stessa pagina 
(delle quali una, ovviamente, destinata alla 
stampa), è sicuramente molto valida e sem- 
plice da realizzare, ma presenta molteplici 
inconvenienti legati soprattutto ai tempi di 
sviluppo e alla difficoltà di tener conto, a 
volte, di minime differenze tra una versione e 
l'altra (es. spesso la versione stampabile dif- 
ferisce da quella normale soltanto per un 
pulsante o una barra dei menu). Ma tale tec- 
nica costringe il webmaster anche a ricorrere 
ad artifici particolari, per ottenere determi- 
nati effetti di uso comune. 



FACCIAMOLO 
CON I CSS 

Vediamo ora di affrontare il problema intera- 
mente con i CSS: in questo caso non creiamo 
più versioni dello stesso documento, ma 
semplicemente applichiamo uno stile diver- 
so a seconda del mezzo di visualizzazione 
che intendiamo gestire. L'unico vincolo al 
quale dobbiamo attenerci, se vogliamo sfrut- 
tare appieno la potenza dei CSS, è l'organiz- 
zazione del codice (X)HTML secondo una 
struttura semantica, che impone di separare 
accuratamente i contenuti dalle logiche di 
presentazione e visualizzazione (le quali 
devono essere gestite interamente dai fogli di 
stile). Innanzitutto ecco l'elenco dei valori 
possibili per l'attributo media, accompagnati 
dai dispositivi di visualizzazione a cui si rife- 
riscono: 

• ali: è il valore di default valido per tutti i 
mezzi di diffusione della pagina; 

• aural: browser a sintesi vocale; 

• braille: supporti basati sull'uso del braille; 

• embossed: stampanti braille; 

• handheld: palmari e dispositivi portatili 
vari; 

• print: stampa su carta; 

• projection: è impiegato per proiezioni e 
presentazioni a tutto schermo; 

• screen: visualizzazione su schermo; 

• tty: dispositivi a carattere fisso; 

• tv: web -tv. 

L'attributo media può essere usato sìa con 
l'elemento LINK che con l'elemento STYLE: 

<link rel = "stylesheet" type="text/css" 

media = "screen" href="foglio_video.css" > 
<link rel = "stylesheet" type="text/css" 



HTm 



COME 

UTILIZZARE 

I FILE 

DI ESEMPIO 

Sul CD allegato sono 
disponibili i file di 
esempio, raccolti in tre 
cartelle. E' sufficiente 
salvare le cartelle sul 
disco rigido, quindi 
aprire con un browser 
la pagina index.html 
presente in ciascuna di 
esse e utilizzare i link 
presenti per effettuare 
le varie operazioni 
(mandare in stampa il 
documento, visionarne 
il codice sorgente, 
ecc.). 




TRUTTURA GRAFICA O STRUTTURA 



I I Ini 'i ■■ ' w^^m 

Nel testo si è fatto riferimento 
alla struttura semantica, che 
impone una rigida separazione 
tra i contenuti (gestiti con 
l'XHTML) e le logiche di 
presentazione e visualizzazione 
(specificate nei fogli di stile). 
L'opposto della struttura 
semantica è la struttura grafica, 
tipica di molti siti che usano le 
tabelle, per esempio, non tanto 
per organizzare in modo logico 
le informazioni, ma piuttosto 
come "griglia" per suddividere i 
vari contenuti. Allo stesso 
modo, per esempio, la struttura 



grafica gestisce spesso i menu 
tramite i contenitori generici 
HTML (i DIV), mentre a livello 
semantico è molto più rigoroso 
usare le liste. Per ulteriori 
informazioni concernenti la 
realizzazione di documenti 
"well-formed" in XHTML, 
consiglio di visitare il seguente 
validissimo link: 
http://www.w3schools.com, che 
contiene vari tutorial su tutto 
ciò che riguarda il web, con 
linguaggio semplice e 
accessibile. Unico 
inconveniente: è in inglese !!! 
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media = "p 


rint"href=' 


"fogl 


io_stampa.css" 


> 


oppure: 


<style type="text/css"> 


@import 


url(foglio_ 


.video, css) 


i screen; 






@import 


url(foglio_ 


.stampa. css) p 


rint; 






</style> 


o ancora 


per i fogli 


di stile in 


line: 








<style type="text/css"> 


@media 


screen { 














/* qui 


andranno 


inseriti gli stili riferiti 
visualizzazione 


alla 
a video 


*/ 




} 


@media 


print { 














/* qui 


andranno 


inseriti gli 


stili 


riferiti 


alla 
stampa 


*/ 




} 


</style> 




All'interno dell'attributo media, che è opzio- 
nale, si possono inserire anche più valori, 
separati tra loro da virgole. Sarà lo user agent 
che dovrà visualizzare la pagina (es. il comune 
browser) a caricare il foglio di stile giusto, 
sempre che tale pagina sia strutturata in 
modo corretto. È bene a questo punto segna- 
lare, tuttavia, che la tecnica di stampa delle 
pagine web tramite CSS che stiamo affrontan- 
do non funziona con i browser (come 
Netscape Navigator 4) che non sono in grado 
di interpretare i fogli di stile specifici per la 



CHE niOM USARE IL FRAME? 



I fratrie sono uno degli elementi 
più contestati dalla moderna 
web-usability (l'insieme delle 
regole che devono essere 
rispettate per realizzare siti 
efficienti e conformi ai migliori 
standard qualitativi). Ne 
sintetizzo qui di seguito i 
principali motivi: 

• alcuni browser non li 
gestiscono bene, per cui quando 
si va a inserire una pagina nei 
bookmark (segnalibri) si finisce 
per salvare la prima pagina del 
sito, e non quella effettivamente 
voluta; 

• anche il semplice salvataggio 
della pagina è reso molto più 
difficile dal fatto che non è 
immediatamente visibile ciò che 
si sta realmente salvando; 

• i frame complicano e 
appesantiscono molto la 
struttura della pagina. 



rendendone molto più 
difficoltosa la manutenzione; 
• infine essi si comportano in 
modo imprevedibile in tante 
altre situazioni, rischiando 
talvolta di compromettere la 
normale navigabilità del sito. 
C'è da rimarcare, peraltro, che 
ormai anche i principali punti di 
forza dei frame (es. la barra di 
scorrimento che compare per 
scorrere i contenuti eccedenti le 
dimensioni del riquadro) sono 
supportati pienamente dai layer, 
i quali però non presentano tutti 
gli inconvenienti sopra elencati. 
Per ulteriori informazioni sulla 
corretta realizzazione di siti web, 
fornisco i seguenti link: 
www.usabile.it, 
www.sitichefunzionano.it, 
www.usability.gov, 
www.useit.com (questi ultimi 
due in lingua inglese). 



stampa. Vediamo ora quali sono le principali 
differenze di formattazione tra la visualizza- 
zione a video e la stampa su carta, gestibili 
direttamente tramite CSS: un modo pulito ed 
elegante che ci consente di evitare di ricorrere 
a "giochini" come quelli descritti nei paragra- 
fi precedenti. 



ELIMINAZIONE 
DI ELEMENTI 
DALLA STAMPA 

Il problema che ci siamo posti inizialmente 
era proprio questo: come eliminare determi- 
nati elementi che, nella stampa, risultano 
antiestetici (come menu, pulsanti, link, ecc..) 
o poco professionali (es. banner pubblicitari, 
striscioni vari, ecc.). 

Per poter eliminare il pulsante in fase di stam- 
pa, basta definire nel foglio di stile relativo la 
seguente formattazione: 

#pulsante { 
display: none; 



COLORI 

Ricordiamoci che la pagina su cui stampia- 
mo, generalmente, è bianca, quindi sarà 
meglio impostare caratteri di colore scuro su 
sfondo bianco: 



body { 


background: 


white; 


color: black; 


} 


#contenuto { 


background: 


transparent; 


} 



Sicuramente il colore scuro è la scelta miglio- 
re, in quanto consente un maggiore contrasto 
con lo sfondo, e quindi una maggiore leggibi- 
lità. 



CARATTERI 

Per quanto concerne il carattere da utilizzare, 
c'è da dire che sullo schermo la risoluzione 
dei pixel è limitata, pertanto in genere si 
usano caratteri semplici e senza particolari 
elaborazioni: meglio quelli senza grazie 
("sans-serif") come Verdana o Helvetica. Le 
dimensioni dei caratteri, inoltre, sono in 
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genere espresse in pixel. Su carta invece la 
risoluzione disponibile è molto superiore, per 
cui è consigliabile usare caratteri con grazie 
("serif") come il Times. La dimensione dei 
caratteri stampati può essere anche inferiore 
rispetto a quella adottata per il video, visto 
che la lettura su carta è meno faticosa: questo 
consente sicuramente di risparmiare inchio- 
stro e fogli. Essa, poi, come spiegheremo 
meglio nel prossimo paragrafo, è in genere 
espressa in punti. 

body { 

font: lOpt Times New Roman; 



SCELTA DELLE UNITA 
DI MISURA 

Dato che il video dei PC è basato sui pixel, l'u- 
nità di misura più adatta per la misurazione 
dei suoi elementi sarà sicuramente il pixel. 
Sulla carta tale unità di misura non ha certa- 
mente molto senso, mentre sarà più opportu- 
no utilizzare i punti (come abbiamo visto, per 
i caratteri) e i millimetri (per tutto il resto). 
Ricordiamoci anche che il foglio più utilizzato 
per le stampe ha il formato standard A4: 210 x 
297 millimetri. Utilizzando i millimetri, abbia- 
mo un controllo molto più diretto sul risulta- 
to finale della nostra stampa: 

p { text-indent: 15mm; } 



COLLEGAMENTI 

Come per la normale rappresentazione su 
schermo, anche le pagine stampate dovrebbe- 
ro avere bene in evidenza i link. Basterà impo- 
stare per essi una formattazione particolare, 
privilegiando il grassetto e la sottolineatura. È 
possibile, inoltre, cambiare colore ai link (es. 
blu scuro). I link visitati dovrebbero anche 
avere lo stesso aspetto di quelli non ancora 
visitati. 



utilità: 



a : link, a:visited { 


text-decoration: 


underline; 


font-weight:bold; 


} 



I fogli di stile consentono anche di visualizza- 
re l'indirizzo del sito web di riferimento, 
accanto al testo del link, in modo da dare 
un'informazione in più sulla carta dove il 
testo da solo, altrimenti, non avrebbe alcuna 



a: 


link: after, 


a: 


visited: after 


{ 




content: ' 


„ ( 


"attr(href)") 


"; 


} 



Questo metodo presenta però due inconve- 
nienti: intanto non funziona su browser che 
non interpretano al meglio i fogli di stile, 
come Internet Explorer 6 e Opera 6. Inoltre, 
l'indirizzo visualizzato dopo il nome del colle- 
gamento è l'attributo "href" del link stesso. 
Quindi, per i link esterni non ci sono proble- 
mi, in quanto l'attributo "href" coincide con 
l'URL, ma per i link interni al sito, che in gene- 
re vengono espressi in modo assoluto (es: 
/percorso _assoluto/pippo.html) o in modo 
relativo (es. ../../cartella/pagina.html ), l'indi- 
cazione di tale attributo è in effetti di scarsa 
utilità. Ci vengono in aiuto, quindi, in attesa 
che la specifica CSS di livello 3 intervenga per 
correggere questo problema, le seguenti due 
classi, riferentisi rispettivamente ai link inter- 
ni e a quelli esterni: 



a.link-interno:after { 


content:' 


' [http://www, 


,sitoweb.com/"attr(href) 


} 


a.link-esterno:after { 


contenti' 


' [" attr(href) 


"]" 




} 



CONCLUSIONI 

I file di esempio relativi a quest'articolo sono 
disponibili direttamente nel CD allegato al 
presente numero. 

I CSS rappresentano una risorsa importante a 
cui ogni programmatore dovrebbe affidarsi 
nella progettazione della propria applicazio- 
ne. Vero è che sono nati per consentire la crea- 
zione di layout più raffinati, ma è anche vero 
che se usati con sapienza, i CSS possono rap- 
presentare la soluzione a problemi molto 
comuni come ad esempio quello della stampa 
analizzato in questo articolo. L'uso corretto di 
tutte le tecnologie in ambito Web dai CSS ad 
Ajax a Javascript è l'unica strada che Internet 
ha per migliorare ancora l'impatto che le 
pagin e hanno sugli utenti Ricordiamoci che 
quando si parla di Web, il risulato finale in ter- 
mine di Output è visibile soltanto all'interno 
del Browser, per questo motivo proprio i CSS 
devono rivestire un ruolo centrale nella pro- 
gettazione di ogni Web Application 

Enrico Viale 
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MYSQL HIBERNATE 
EDECLlPSE:ILTRIORE 

OGGI, GRAZIE A STRUMENTI OPEN SOURCE, È POSSIBILE IMPLEMENTARE SOLUZIONI 
SOFTWARE ESTREMAMENTE EFFICIENTI E FUNZIONALI IN TEMPI E COSTI NEMMENO 
IMMAGINABILI FINO A POCO TEMPO FA. 




Solitamente quando si progetta o sviluppa un 
"software gestionale", sia che esso si occupi di 
gestione del magazzino o di contabilità o altro an- 
cora, ci si deve sempre dividere in due. Infatti, una 
volta raccolti i requisiti da parte del cliente (in gene- 
rale del futuro utilizzatore del software), bisogna far- 
si carico di due aspetti fondamentali che poi debbo- 
no essere fatti cooperare: 

• la progettazione del database che tenga conto di 
tutti i dati necessari e delle loro relazioni 

• la progettazione dell' applicazione che renda pos- 
sibile all'utilizzatore stesso di realizzare in manie- 
ra agevole tutte le operazioni necessarie al funzio- 
namento del sistema informativo (per capirci in- 
terfacce grafiche e gran parte della business logie) . 

Far interagire questi due aspetti non è così immedia- 
to e semplice come può apparire in un primo mo- 
mento; gli ostacoli che possono presentarsi all'inte- 
grazione di questi due componenti possono essere 
molteplici; di seguito ne elenchiamo alcuni a cui ten- 
teremo di dare una risposta. 



DATABASE 

E APPLICAZIONI UTENTE 

Il primo ostacolo riguarda le differenze di skill in 
possesso delle figure che si occupano di progettare 
i database rispetto a quelle in possesso di chi svi- 
luppa applicazioni front-end (siano esse lato web, Win32 
etc...). Nel primo caso infatti si adotta ad esempio 
il paradigma entità relazione (solitamente indicato 
con l'acronimo E-R), mentre nel secondo sarà si- 
curamente presente, tra le tante possibili, una filo- 
sofia object oriented. Inoltre non bisogna dimenti- 
care che, dal punto di vista implementativo, questi 
"due mondi" utilizzano linguaggi profondamente 
diversi: da un lato avremo un dialetto SQL, mentre 
dall'altro un linguaggio procedurale (tipo C) o 00 (ti- 
po C++, JAVA etc...). Sotto l'aspetto architetturale le 
comunicazioni tra il database e l'applicazione av- 
vengono tramite degli appositi driver che si fanno ca- 



rico di gestire la connessione al RDBMS, trasfor- 
mare in eccezione gli errori generati dal database, 
inoltrare le query dall'applicazione al DB e restitui- 
re i risultati dell'interrogazione sotto forma di clas- 
se (si pensi ai DataSet in .NET o ResultSet in Java) e 
così via. È proprio in questa "terra di mezzo" che si 
rilevano le maggiori difficoltà: infatti, ad esempio, 
se chi ha implementato il lato front- end non è la 
stessa persona che ha progettato ed implementato 
il lato back-end può spesso capitare che il primo 
passi dei parametri che il DB non si aspetti. Per tut- 
ta risposta dal lato DB verrà generato un errore di 
difficile interpretazione. 



PERSISTENZA DEGLI 
OGGETTI... MA NON SOLO 

Per tutti i motivi sopra elencati è nata l'esigenza 
di trovare un modo che permettesse di utilizzare gli 
oggetti interfacciandosi al db in maniera del tutto 
trasparente. 

Quando si parla di persistenza degli oggetti si pos- 
sono intendere varie tecniche, anche diverse tra 
loro. In questo articolo per persistenza degli og- 
getti intenderemo un cosa molto semplice (alme- 
no concettualmente parlando): 
salvare e recuperare un oggetto in o da una tabella 
di un database. 

In altre parole vogliamo instaurare una relazione 
biunivoca tra una tabella di un database ed una 
classe, o meglio, tra un record della tabella e l'i- 
stanza di una classe. In questo modo sarà possi- 
bile utilizzare il paradigma object oriented senza 
preoccuparci degli aspetti legati specificatamen- 
te al database. Il prodotto che rende possibile tut- 
to ciò (e molto di più) è il framework open source 
Hibernate, sarà infatti questo ultimo a farsi carico 
degli aspetti discussi fino ad adesso. La figura 1 ri- 
porta l'architettura complessiva di una applica- 
zione basata su Hibernate. Senza scendere trop- 
po nei particolari notiamo proprio che Hibernate 
si pone, a livello logico, tra lo strato applicativo ed 
il driver JDBC. 
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Applicazione 


P 


H ibernate 
Framework 

IL \ 


r 


Driver JDBC 




j^^ 


r^, 


Datobas* (MySQL) 








^^—^ 



% REGIA ID % int default NULL 



x REGIA_COGNOME , varchar(20) default NULL, 



F/j* 1: Architettura complessiva di una applicazione 
basata su Hibernate 



Ul\l CASO REALE: GESTIAMO 
L'ORGANIZZAZIONE 
DELLA NOSTRA VIDEOTECA 

Invece di dilungarci in considerazioni sulle funzio- 
nalità di questo potente framework (che sono nu- 
merosissime), vedremo come utilizzarlo da subito 
anche grazie all'aiuto di un validissimo plugin per 
Eclipse. Ad ogni modo, oltre all'abbondante docu- 
mentazione bibliografica presente su Internet, per 
chi volesse approfondire ulteriormente alcuni aspet- 
ti di configurazione ed architetturali, l'articolo pubblicato 
sul numero di maggio sul suo "fratello" Nhibernate 
può sicuramente rappresentare un valido punto di 
riferimento. Tornando a noi, definiamo come prima 
cosa il problema che andremo ad affrontare, simu- 
liamo cioè la fase che viene definita come "raccolta 
dei requisiti": 

La base di dati deve gestire l'elenco dei video in pos- 
sesso dell'utente. Ogni video è memorizzato su uno 

più supporti (nel caso di copie di backup) che 
debbono essere identificati da un numero univoco. 
Ogni video è identificato da un titolo e, per ciascu- 
no di esso, possono essere specificate ulteriori 
informazioni come la data di uscita, il genere, il 
regista ed il cast di interpreti. Sia per i registi sia per 
gli interpreti è necessario specificare nome e cogno- 
me ed eventualmente la loro data di nascita. Per 
quanto riguarda il genere del filmato esso è identifi- 
cato da un proprio nome (comico, drammatico, 
video clip, etc...). Questa non è la sede per discutere 
di progettazione E-R, quindi puntualizzeremo solo 
alcuni aspetti del nostro database, rimando quindi 
allo script in allegato alla rivista. 

1 vincoli esposti nei requisiti ci costringo a definire una 
tabella "interpretazione" che ci permetta di risolvere la 
relazione molti a molti che sussiste tra la tabella Film 
e la tabella Attore. 

Ecco infatti la struttura della tabella Film e quella di 
Interpretazione: 

CREATE TABLE 'FILM* ( 
X ID X int(ll) NOT NULL autojncrement, 
% TITOLO * varchar(50) NOT NULL default ", 



^ GENERE ^ varchar(20) default NULL, 



^ USCITA ^ date default NULL, 



PRIMARYKEY fID % ), 



KEY*REGIA_ID % f REGIA_ID % ), 



KEY^ID* fID % ), 



KEY*R_9 % C GENERE*), 



CONSTRAINT *direttoDa* FOREIGN KEY 

fREGIA_ID % ) REFERENCES * REGISTA* flD*), 
CONSTRAINT *R_9* FOREIGN KEY (* GENERE* ) 

REFERENCES * GENERE* (*NOME*) 
) ENGINE=InnoDB DEFAULT CHARSET= latini; 

CREATE TABLE * INTERPRETAZIONE* ( 



*ATTORE_ID* int(ll) NOT NULL, 



*FILM* int(ll) NOT NULL default '0', 



PRIMARYKEY (* ATTORE_ID* ,* FILM* ), 



KEY*ATTORE* (* ATTORE_ID* ), 



KEY*R_8* (*FILM*), 



CONSTRAINT *R_7* FOREIGN KEY (* ATTO RE_ID* ) 

REFERENCES * ATTORE* (*ID*), 
CONSTRAINT * R_8* FOREIGN KEY (* FILM* ) 

REFERENCES *FILM* (*ID*) 
) ENGINE=InnoDB DEFAULT CHARSET=latinl; 

Da notare inoltre come l'engine scelto sia InnoDB in 
modo tale che siano supportate anche le transazioni. 



MENOMALE 
CHE CE ECLIPSE! 

Una volta creato il database dovremo occupar- 
ci di tutta la configurazione necessaria per in- 
terfacciare Hibrnate a quest'ultimo. Per chi di voi 
non avesse avuto nessuna esperienza in tal sen- 
so vi posso assicurare che si tratta di un'opera- 
zione alquanto tediosa, soprattutto per data- 
base di medio-alta complessità, che molte vol- 
te scoraggia lo sviluppatore ad utilizzare il fra- 
mework stesso. Per nostra fortuna gli sviluppa- 
tori di Hibernate hanno creato un plugin per 
eclipse che ci sgrava da questi compiti auto- 
matizzando molti degli aspetti più meccanici. 
Prima di tutto, oltre al framework in questione, 
procuriamoci tale plugin (hibernate.org/255.html) 
ed installiamolo su Eclipse. A questo punto creia- 
mo un nuovo Java Project ed assicuriamoci di 
referenziare tutte le librerie necessarie a Hi- 
bernate (per intenderci i JAR presenti nella sot- 
to directory lib di hibernate più lo stesso hi- 
bernate.jar) e che i nostri sorgenti abbiano co- 
me directory principale src. 
La prima cosa da fare è creare il file hiberna- 
te. cfg.xml che conterrà le informazioni gene- 
rali per connettersi al database. I passi da se- 
guire sono i seguenti: 




SVILUPPO 
TRADIZIONALE 

Come si vede dalla 
figura 1 l'utilizzo 
di Hibernate non 
preclude comunque 
la possibilità di 
continuare a 
sviluppare il codice 
interfacciandosi 
direttamente al JDBC. 
Questa precisazione è 
molto importante per 
tutti coloro che hanno 
applicazioni che 
utilizzano 
direttamente il 
database e vogliono 
affiancare una nuova 
soluzione basata su 
hibernate. 



COSA È LA 
PERSISTENZA? 

Per persistenza 
degli oggetti si può 
intendere 

genericamente tutte 
quelle tecniche che 
permettono di 
memorizzare lo 
stato degli oggetti 
su un qualsiasi 
supporto. La 
serializzazione ad 
esempio ci permette 
di salvare un 
oggetto su un file 
binario, In questo 
articolo quando 
parliamo di 
persistenza 
intendiamo sempre 
il salvataggio di un 
oggetto in un 
database. 
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INSTALLARE 

UM PLUGIM IN 

ECLIPSE 

Per installare un plugin 

basta decomprimere lo 

zip relativo nella root 

di installazione di 

Eclipse. 



DRIVER JDBC IN 
HIBERNATE 

Hibernate fornisce 

un proprio JDBC per 

connettersi a 

MySQL, nella 

fattispecie 

org.gjtmm.mysql 

.Driver. Quello che mi 

sento di consigliare 

è di scaricare il JDBC 

fornito sul sito della 

stessa MySQL e di 

cambiare la relativa 

riga di 

configurazione con 

coiti, mysql.jdbc 

.Driver. 



Select a wizard 

Create a new hibernate. cfg^xrnl file (Helping with the in iti al JDBC setup 
etej 

Wizard 5: 

© : interface 

l^Java Project 

4r Java Project from Existing Ant Buildfile 

SjS Plug-in Project 

S" Product Configuration 
|> &CVS 
|> &GU!Forms 
' &H ibernate 



I 



: 



Scegliere File -> New -> Other dal menù di Eclipse, se- 
lezionare Hibernate Configuration File e premere Next 



| HilH-iruinArrt OffKÀ « 



■■ uhi 

'■> iJHlbcmUeCOSliDcOl 
» l^HibemJlePrcwj 
' :."v.n:.U 



""6J* [i 



Selezionare la cartella src del vostro progetto e clicca- 
re su Next. 
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<session-factory name="wrapFactory"> 
<property name="hibernate. connection 
.driver_class">org.gjt.mm.mysql.Driver</property> 
<property name="hibernate. connection. 

password" >pwd</property> 
<property name="hibernate. connection 
.url">jdbc:mysql://localhost/cd_stage01</property> 
<property name="hibernate. connection. 

usemame">user</property> 
<property name="hibernate.dialect">org. 
hibernate. dialect.MySQLInnoDBDialect</property> 



A questo punto aggiungiamo due ulteriori property: 

<property name="hibernate. connection. zeroDate 

TimeBehavior">convertToNull</property> 

<property name="hibernate.current_session_ 

context_class">thread</property> 

La prima ci assicura che una data non assegnata, che 
in database compare come 00-00-0000 00:00, verrà ri- 
mappata in Java come un oggetto nuli, mentre la seconda 
ci assicura che la sessione di Hibernate sia un thread. 



Scegliere un nome per la session-factory, selezio- 
nare il tipo di database che si vuole utilizzare ed il 
relativo JDBC, e gli ulteriori parametri necessari 
(connectionURL, username, password etc...). In- 
fine spuntate la voce Create a Console Configura- 
tion e premete Next 

Come ultima operazione diamo un nome alla con- 
sole. 

Ora, all'interno della cartella src, dovremo avere il 
file XML hibernate. cfg.xml. Cliccandolo due volte 
si aprire un editor XML dedicato; il contenuto del 
file in questione dovrebbe essere questo: 



ED ORA IL REVERSE 
ENGINEERING! 

Quello che ora dovremmo fare, visto che siamo 
partiti dalla progettazione del database, è defini- 
re delle classi che mappino le tabelle create in da- 
tabase. In particolare per Hibernate bisogna seguire 
lo standard JavaBeans. Per scendere subito nelle 
considerazioni concrete diciamo quindi che ogni 
classe mappa una tabella dichiarando i campi di 
quest'ultima come variabili private ed esponen- 
do i relativi metodi pubblici set/get. Facendo un 
esempio concreto sulla tabella CD del nostro DB 
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abbiano: 



CREATE TABLE % CD % ( 



'NUMERO* int(ll) NOT NULL AUTOJN CREME NT, 



PRIMARYKEY ('NUMERO'), 



KEY 'NUMERO' ('NUMERO') 



) ENGINE=InnoDB DEFAULT CHARSET=latinl; 

A questa tabella corrisponderà la seguente classe: 



public class Cd { 



// Fields 



private int numero; 



/** default constructor */ 



public Cd(){ 



} 



/** minimal constructor */ 



public Cd(int numero) { 



this. numero = numero; 



} 



// Property accessors 



public int getl\lumero() { 



return this. numero; 



} 



public void setl\lumero(int numero) { 



this. numero = numero; 



Create H ibernate Reverse Engineering file (reveng.xml) 

Create a new hibemate.reveng.xmL 

Enter or select the parent folder: 
|HibernateAppCD/src 



H 4® O 

^ t^HibernateAppCD 
> &bin 




3 Selezionare la console configuration e cliccare 
sul bottone Refresh in modo tale da connettersi 
al database. A questo punto selezionare tutte le 
tabelle e premere il bottone Include 



} 



Con tigni e Tabi e Fìlters 








♦ é 




Specify which catalog/schema/tables 
reverse engineering. 


should be induded or excluded from the 


W 




C on s ole e onf i g u rati on : | w rapC onf \q u rati on 






H 


Database schema: 
w llcd_stage01 

^Hpfijjl 1 'include..^ 






















ffYcatalog 


"Schema 


Table 


1 


cd_5tage01 
cd_stage01 




ATTORE 

CD 




^^^3 Exclude... 


cd_stage01 
cd_stage01 


• 


CONTIENE 
FILM 




: :: 


cd_stage01 
cd_stage01 


M 


GENERE 
iNTERPRETAZIOr- 




cd_stage01 


.* 


REGISTA 
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In realtà vedremo che sarà conveniente avere 
dei SET che tengano conto anche delle relazio- 
ni tra le classi. Per ora però fermiamoci un atti- 
mo e riflettiamo: in fondo tutte queste opera- 
zioni sono meccaniche e quindi facilmente au- 
tomatizzabili! Anche in questo caso il plugin 
messo a disposizione da Hibernate ci risparmia 
un sacco di fatica, basta seguire i passi sotto ri- 
portati: 

1 Selezionare New -> Other -> Hibernate -> 
Reverse Engineering Configuration File e clicca- 
re su Next 



5 New 



Select a wizard 

Create a new hibernate .reveng.xml (Helping with the initial table and type 
fi Ire ring) 

Wizards: 



ìj£ Plug-in Project 
EÉjProctuct Configuration 

> &CVS 

> &GUIForms 
^ & Hibernate 

'# Hibernate Configuration File (cfg.xml) 
** Hibernate Console Configuration 



I Selezionare la directory dove sarà posto il file di 
, reverse engineering 



4 Dopo aver cliccato sull'icona di Hibernate sele- 
zionate Hibernate Code Generation. Sul tab 
Exporters selezionate generate domain code e gene- 
rate mappings come mostrato in figura, infine clic- 
cate su run. 
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Una volta completati tutti passi descritti sopra 
dovreste avere un package contenente tutte le classi 
che mappano le vostre tabelle e le relative relazioni 
fra esse. Inoltre vengo anche generati i file XML che 
definiscono quale campo di quale tabella debba 
essere mappato sull'attributo di quale classe. Ad 
esempio abbiano per la classe Cd il file Cd.hbm.xml: 

<hibernate-mapping> 

<class name="wrap.Cd" table="CD" 

catalog="cd_stage01"> 
<id name="numero" type="int"> 
<column name="NUMERO" /> 



<generator class="assigned" /> 
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QUALE 
DATABASE? 

LRDBMS che si è 

scelto per questo 

articolo è il famoso 

MySQL, anche se in 

realtà utilizzando 

Hibernate potete 

scegliere il database 

che più preferite 

purché siate in 

possesso del relativo 

JDBC In allegato alla 

rivista troverete un 

file script 

(create_db.sql) che vi 

creerà 

automaticamente il 

database su cui stiamo 

lavorando. Nel caso in 

cui anche voi abbiate 

deciso di avvalervi di 

MySQL i passi da 

seguire per creare il db 

sono semplicissimi: 

1- Collegarsi al RDBMS 

mysql -u <utente> -p 

2- Creare il DB 



create database 

<nomedatabase> 

3- Uscire dal terminali 



</id> 



<set name="contienes" inverse="true"> 



<key> 



<column name="CD" not-null="true" /> 



</key> 



<one-to-many class="wrap. Contiene" /> 



</set> 



</class> 



</hibernate-mapping> 

Ora l'unica cosa che c'è rimasta da fare è aggiungere 
al file di configurazione hibernate.cfg.xml tutti gli XML 
di mappaggio che il nostro tool ha generato. Nel nostro 
caso ad esempio basterà aggiungere: 

<hibernate-configuration> 

<session-factory name="wrapFactory"> 

<mapping resource="wrap/Cd.hbm.xml7> 
<mapping resource="wrap/ Attore. hbm.xml7> 



<mapping resource="wrap/ 



Contiene. hbm.xml7> 



<mapping resource="wrap/Film.hbm.xml7> 
<mapping resource="wrap/Genere.hbm.xml7> 
<mapping resource="wrap/ 

Interpretazione. hbm.xml7> 
<mapping resource="wrap/Regista.hbm.xml7> 



Come avrete potuto sicuramente notare è necessario 
specificare il percorso completo delle risorse XML 
(wrap è infatti il package dove sono contenute). 



ED ORA GODIAMOCI 

uni pò 1 di codice ira stile 



Siamo quindi ormai pronti per fare le nostre prime 
esperienze con questo framework. Partiamo ad esem- 
pio da una procedura banale: inseriamo un numero di 
CD nuovo in maniera transazionale (visto che come en- 
gine abbiano scelto InnoDB): 



» 



In pratica come vedete non bisogna far altro che crea- 
re la vostra classe e salvarle tramite una sessione Hi- 
bernate. Ricordate inoltre che i salvataggi o gli upda- 
te vengo effettivamete persistiti sul database solo quan- 
do viene invocato il metodo commit della sessione in 
questione. La classe HibernateUtil è una classe che 
ho implementato per rendere più agevole e rapido la- 
vorare con le sessioni: 



Public class HibernateUtil { 



Private static final SessionFactory sessionFactory; 
static{ 

sessionFactory = new 
Configuration().configure().buildSessionFactory(); 



} 



public static SessionFactory getSession Factory() { 
return sessionFactory; 



} 



} 



Per concludere vediamo come recuperare i CD che 
abbiano salvato sul database: 

public static Cd[] getAII() throws HibernateException { 
Session s = HibernateUtil. 
getSessionFactory().getCurrentSession(); 
try{ 

s.beginTransaction(); 
List res = s. create 
Query("from wrap.Cd").list(); 
Cd[] out = new 

Cd[res.size()]; 
out=(Cd[])res.toArray(out); 
s.close(); 
return out; 



} catch (HibernateException e) { 



catch block 
throw e; 



exit 



4- Lanciare lo script 

mysql -u <utente> -p 

<nomedatabase> < 

create_db.sql 



Session 


session = 


HibernateUtil. getSessionFactory(). 

getCurrentSessionQ; 


session, 


,beginTransaction(); 






Cd ed = 


newCdQ; 




cd.setNumero(l); 


try{ 


session. save(cd); 




session 


.get Transaction().commit(); 


} catch (HibernateException e) { 


// TODO Auto-generated catch block 
session. get 
Transaction().rollback(); 






System. 


out.println(e. 

getMessageQ); 



CONCLUSIONI 

Come avrete notato da quest'ultimo stralcio di codi- 
ce, Hibernate non fa uso del linguaggio SQL ma di 
qualcosa che gli assomiglia molto. Su questo aspetto 
torneremo nel prossimo articolo, per ora abbiano però 
già capito come, grazie a questo plugin, sia facile ave- 
re il framework configurato e pronto per l'uso. Inoltre 
prossimamente potremmo apprezzare come Hibernate 
ci agevoli anche nel progettare sistemi di GUI molto 
accattivanti. 

Andrea Galeazzi 
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DA SQL SERVER AL 
WEB IN UN LAMPO 

LA NUOVA VERSIONE DEL DATABASE DI MICROSOFT, OFFRE UN SUPPORTO MIGLIORATO AD 
XML. VEDIAMO COME OTTENERE I DATI DIRETTAMENTE IN QUESTO FORMATO E COME 
TRASFORMARLI GRAZIE AD XSLT. 





I i conoscenza di base di 
VB.NET, SQL e XSL 



» 



Visual Studio 2005 
anche in versione 
Express, Microsoft SQL 
Server anche in 
versione Express 



000 



Tempo di realizzazione 



Microsoft SQL Server, a partire dalla 
versione 2000 ancor di più con la ver- 
sione 2005, ha introdotto un suppor- 
to a XML veramente notevole. 
XML viene utilizzato in Sql Server in diversi mo- 
di, in questo articolo, però, focalizzeremo la 
nostra attenzione al recupero dei dati. 
Di cosa si tratta? In pratica della possibilità di 
estrarre i dati con una normale query per aver- 
li disponibili direttamente in formato XML. 
A cosa serve? Pensiamo ad uno scenario di una 
Web Application dove abbiamo l'esigenza di 
estrarre i dati dal database per poi trasformar- 
li in HTML per mostrarli in una pagina web. 
Il metodo classico di fronte a questa esigenza, 
inASP.NET, è solitamente quello di utilizzare il 
controllo DataGrid con l'associazione ai dati, 
oppure quello di costruire manualmente il co- 
dice HTML aprendo la connessione, scorren- 
do i dati e scrivendoli nell'output. 
Entrambi questi sistemi presentano dei difetti: 

• il primo approccio, con il controllo Data- 
Grid, è troppo limitativo poiché il controllo 
sull'output (la tabella HTML che ne risulta) 
è, per forza di cose, abbastanza difficile; for- 
mattare tabelle molto complesse, magari con 
un po' di codice Javascript o icone, è certo 
possibile ma, alla fine, risulta più complica- 
to che scrivere direttamente il codice HTML 

• il secondo metodo, quello preferito dai pro- 
grammatori che vengono dalla scuola del- 
l'ASP classico o del PHP, offre sicuramente 
più libertà ma ha il grave difetto di mischia- 
re i dati con la logica di presentazione, con l'ef- 
fetto che, successivamente, per cambiare an- 
che solo il carattere del testo di una cella oc- 
corre scorrersi decine e decine di righe di co- 
dice. 

Avere invece i dati in formato XML ci consente 
di trasformarli direttamente in HTML utiliz- 



zando XSLT, il linguaggio per la trasformazione 
di un sorgente XML beneficiando sia della se- 
parazione tra dati e contenuto che di un com- 
pleto controllo sull'output da creare. 
Per entrare un po' più sul concreto proponiamoci 
un obbiettivo preciso. Costruiremo una mini 
applicazione composta da due pagine web : 
nella prima mostriamo gli ordini ricevuti in una 
tabella, cliccando sull'ordine si aprirà nella se- 
conda pagina la fattura per il cliente. 



ESTRARRE I DATI 

Per ottenere i dati in XML con una query, in SQL 
Server, è sufficiente utilizzare una clausola, FOR 
XML, in coda al testo della query. 
Prendiamo, ad esempio, la query sugli ordini : 

SELECT TOP 10 

OrderID,Orders.CustomerID,OrderDate, 

RequiredDate,ShippedDate,ShipName, 
ShipAddress, 

ShipCity,ShipPostalCode,ShipCountry, 

CompanyName,Address,City,Country,PostalCode 

from Orders 

inner join Customers 

ON Orders. CustomerID=Customers.CustomerID 



F 


esulti j Messages| 










OrderID 


CustomerID 


OrderDate | RequiredDate 


GhippedDate 




1 
2 


"TÌÒ7G 


RATTC 


1998-05-06 00:00:00.000 


1998-06-03 00:00:00.000 


NULL 


B0NAP 


1998-05-06 00:00:00.000 


1998-06-03 00:00:00.000 


NULL 


3 


11075 
11074 
11073 
11072 
11071 
11070 
11069 


RICSU 


1998-05-06 00:00:00.000 


1998-06-03 00:00:00.000 


NULL 


4 


SIM0B 


1998-05-06 00:00:00.000 


1998-06-03 00:00:00.000 


NULL 


5 


PERIC 


1998-05-05 00:00:00.000 


1998-06-02 00:00:00.000 


NULL 


G 


ERNSH 


1998-05-05 00:00:00.000 


1998-06-02 00:00:00.000 


NULL 


7 


LILÀ3 


1998-05-05 00:00:00.000 


1998-06-02 00:00:00.000 


NULL 


8 


LEHMS 


1998-05-05 00:00:00.000 


1988-06-02 00:00:00.000 


NULL 


9 


T0RTU 


1998-05-04 00:00:00.000 


1998-06-01 00:00:00.000 


1998-05-06 00: 00: 00. 00C 


10 


11068 


QUEEN 


1998-05-04 00:00:00.000 


1988-06-01 00:00:00.000 


NULL 





Fig. 1: esecuzione query standard 

ORDER BY Orders. orderdate DESC 

Se la eseguiamo in ambiente Management Studio, ot- 
terremo la classica tabella di cui alla figura 1 
Se, invece, aggiungiamo il costrutto FOR XML, così : 
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SELECT TOP 10 



from Orders 



inner join Customers 



ON Orders. CustomerID=Customers.CustomerID 
ORDER BY Orders. orderdate DESC 



FOR XML AUTO 



In modalità AUTO non c'è modo di controllare 
questa nidificazione, mentre è possibile defi- 
nire che i valori delle colonne vengano restituiti 
come elementi anziché come attributi. Tale mo- 
dalità si imposta con l'opzione ELEMENTS, e 
cioè : 







<CU3 

</Orde 
-.-Orcler 

<Cus 
</Orde 
<Orcìer 

<Cus 
</Orde 
<Order 

<Cus 
</Orde 
<Order 

<Cus 
</Orde 
<Order 

<Cus 
</Orde 
<Order 

<Cus 
</Orde 
<Order 

: 



s Orde 

tomers 

rs> 

3 Orde 

tomers 

rs> 

s Orde 

tomers 

rs> 

s Orde 

tomers 

rs> 

s Orde; 

tomers 

rs> 

s Orde; 

toniers 

rs> 

s Orde; 

tomers 

rs> 

s Orde 

tomers 



rID="11077" Cu3tomerID="RÀTTC" OrderDs 
CoiiipanyNaiiìe= ,r Rattle3nake Canyon Groce 



rID= ,r 11076" Cu3tomerID="B0NÀP" OrderDs 
CoiiipanyNaiiìe= ,r Eon app 1 " Addres3= ,r 12 , e 



rID= ,r 11075" Cu3tomerID="RICSU" OrderDs 
CoiiìpanyNaiiìe="Richter Supermarkt." Addr 



rID= ,r 11074" Cu3tomerID="SIH0E" OrderDs 
CoitipanyNaitie= ,r Simons bistro" Address=" 



rID= ,r 11073" Cu3tonierID="PERIC" OrderDs 
CoitipanyNaitie="Pericles Comidas clàsics 



rID= ,r 11072" Cu3tonierID="ERNSH" OrderDs 
CoinpanyNaine= ,r Ernst Handel" Address="F 



rID= ,r 11071" Cu3tonierID="LILA5" OrderDs 
CoiiipanyNaiiìe= "L IL A-Supermer cado " Addr e 



rID="11070" CustomerID="LEHH5 ,r OrderDs 
CoiiìpanyNaiiìe="Lehniann3 Harktstand" Ade 



FOR XML AUTO,ELEMENTS 



Fig. 2: esecuzione query XML 

Il risultato sarà un documento XML come mo- 
strato in figura 2. 

Accanto al costrutto FOR XML dobbiamo sem- 
pre impostare la modalità con cui SQL Server 
deve formattare l'output, le modalità sono AU- 
TO, RAW ed EXPLICIT. 



MODALITÀ DI OUTPUT 

La modalità più semplice per definire l'output 
della query è AUTO. In questo caso SQL Server 
scrive la riga in un nodo dallo stesso nome del- 
la tabella, e i valori delle colonne come attri- 
buti, come in: 



E dà luogo ad un output del tipo : 



<Orders> 



<OrderID>11077</OrderID> 



<CustomerID>RATTC</CustomerID> 
<OrderDate>1998-Q5-06T0Q:Q0:Q0</OrderDate> 
<RequiredDate> 1998-06 

03T00:00:00</RequiredDate> 
<ShipName>Rattlesnake Canyon 

Grocery</ShipName> 
<ShipAddress>2817 Milton Dr.</ShipAddress> 
<ShipCity>Albuquerque</ShipCity> 

<ShipPostalCode>8711Q</ShipPostalCode> 

<ShipCountry>USA</ShipCountry> 
< Customers > 
<CompanyName>Rattlesnake Canyon 

Grocery</CompanyName> 
<Address>2817 Milton Dr.</Address> 
<City>Albuquerque</City> 
<Country>USA</Country> 

<PostalCode>8711Q</PostalCode> 

</Customers> 
</Orders> 



La modalità RAW, invece produce un output 
con il nodo corrispondente alla riga chiamato sem- 
pre row e non nidifica le tabelle legate da join . 

FOR XML RAW 



<Orders OrderID="11077" CustomerID="RA7TC" 

OrderDate="1998-05-06T00:00:00" 

RequiredDate="1998-06-03T00:00:00" 

ShipName="Rattlesnake Canyon Grocery" 

ShipAddress="2817 Milton Dr." 

ShipCity="Albuquerque" ShipPostalCode="87110" 

ShipCountry="USA"> ... 

È importante notare che, nel caso in cui nella 
query vi siano dei join ad altre tabelle, l'output 
risulterà nidificato, nel nostro caso : 

<Orders OrderID="11077" ...> 
<Customers CompanyName="Rattlesnake Canyon 

Grocery" Address="2817 Milton Dr." 
City="Albuquerque" Country="USA" 

PostalCode="87110" /> 

</Orders> 



Dà luogo a: 

<row OrderID="11077" CustomerID="RATTC" 

OrderDate="1998-05-06T00:00:00" 

RequiredDate="1998-06-03T00:00:00" 

ShipName="Rattlesnake Canyon Grocery" 

ShipAddress="2817 Milton Dr." 



SQL SERVER MANAGEMENT STUDIO 



Di Sql Server esiste come 
sappiamo anche una versione 
gratuita chiamata Express 
(distribuita con il numero 103 
di loProgrammo). Non 
dimenticate però anche di 
installare anche lo strumento 
di gestione SQL Server 



Management Studio che 
rappresenta la sintesi dei tools 
Query Analizer e Enterprise 
Manager di SQL Server 2000. 
SQL Server Management Studio 
è anche scaricabile all'indirizzo: 
http://msdn.microsoft.com/vstud io/ 



express/sq I/download 
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ShipCity="Albuquerque" ShipPostalCode="87110" 

ShipCountry="USA" Company Name="Rattlesnake 

Canyon Grocery" Address="2817 Milton Dr." 

City="Albuquerque" Country="USA" 

PostalCode="87110" /> 

Anche qui possiamo usare l'opzione ELEMENTS 
per avere un output con elementi: 

<row> 
<OrderID>11077</OrderID> 
<CustomerID>RATTC</CustomerID> 
<OrderDate>1998-05-06T00:00:00</OrderDate> 
<RequiredDate> 1998-06 



<Customer CustomerID="ALFKI"> 



03T00:00:00</RequiredDate> 



<ShipName>Rattlesnake Canyon 

Grocery</ShipName> 
<ShipAddress>2817 Milton Dr.</ShipAddress> 
<ShipCity>Albuquerque</ShipCity> 
<ShipPostalCode>87110</ShipPostalCode> 
<ShipCountry>USA</ShipCountry> 
<CompanyName>Rattlesnake Canyon 

Grocery</CompanyName> 
<Address>2817 Milton Dr.</Address> 
<City>Albuquerque</City> 
<Country>USA</Country> 

<PostalCode>87110</PostalCode> 

</row> 



<Order OrderID=10643> 



<Order OrderID=10692> 



</Customer> 



<Customer CustomerID="ANATR" > 



<Order OrderID=10308 > 



<Order OrderID=10625 > 



</Customer> 
Tale output è prodotto da una query del tipo: 



SELECT 1 as Tag, 



NULL as Parent, 



Customers.CustomerID as 

[Customer!l!CustomerID], 



NULL as [Order!2!OrderID] 



FROM Customers 



UNION ALL 



SELECT 2, 



1, 



Customers.CustomerID, 



Orders.OrderID 



FROM Customers, Orders 



WHERE Customers.CustomerID = Orders. CustomerID 
ORDER BY [Customer!l!CustomerID], 

[Order!2!OrderID] 



SUPPORTO 

XML IN SQL 

SERVER 2005 

Una buona risorsa per 

approfondire le novità 

introdotte nel 

supporto nativo a XML 

da SQL Server 2005 è 

l'articolo pubblicato su 

http://www.dotnethell.it/ 

articles/SQL-Server-2005- 

XML.aspx . 



[ Tag 


Parent 


Customer! 1 ICustomerID 


Order!2!OrderID 


1 


NULL 


ALFKI 


NULL 


2 
2 
2 
2 
2 


1 
1 
1 
1 
1 


ALFKI 
ALFKI 
ALFKI 
ALFKI 
ALFKI 


10643 
10692 
10702 
11011 



Tabella /.- La tabella restituita con l'opzione explicit 



Le modalità AUTO e RAW non impattano sulla 
query di base, mentre per utilizzare la modalità 
EXPLICIT è necessario formattare la query in 
modo da creare una tabella ed. universale. 

La tabella universale deve avere i seguenti re- 
quisiti: 

• La prima colonna specificata nella clausola SE- 
LECT deve essere un numero di tag (Tag) de- 
finito. 

• La seconda colonna specificata deve essere un 
numero di tag (Parent) definito dell'elemen- 
to padre. 

Prendiamo un esempio (tratto dalla documen- 
tazione Microsoft). L'output che dobbiamo ot- 
tenere è : 



FOR XML EXPLICIT 

Che corrisponde alla tabella : 
La modalità EXPLICIT è senz'altro quella più 
complessa da comprendere e da ottenere, tut- 
tavia consente la massima precisione in fatto 
di formattazione finale, per cui vale la pena di ap- 
profondirla. 



SQL SERVER 2005 

I costrutti che abbiamo visto sono utilizzabili 
già a partire da SQL Server 2000, tuttavia la ver- 
sione 2005 presenta molte, interessanti novità. 
In primo luogo c'è da dire che l'output XML pro- 
dotto dalle query che abbiamo visto non pro- 
duce XML sintatticamente valido, ma piuttosto 
un frammento di XML. Ciò avviene perché man- 
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ca un elemento radice univoco in quanto al pri- 
mo livello troviamo sempre un nodo per ogni 
riga della tabella, ciò ci costringeva a rielabo- 
rare, in sede di programma l'output ottenuto 
per inserirlo in un elemento di primo livello. 
SQL Server 2005 ci permette invece di dichia- 
rare F elemento di primo livello in cui inserire 
l'output: 

SELECT TOP 10 

from Orders 

innerjoin Customers 

ON Orders. CustomerID=Customers.CustomerID 

ORDER BY Orders. orderdate DESC 

FOR XML AUTO, ROOTCdocument') 

Produrrà quindi: 

<document> 
<Orders OrderID="11077" CustomerID="RATTC" 

OrderDate="1998-05-06T00:00:00" 

RequiredDate="1998-06-03T00:00:00" 

ShipName="Rattlesnake Canyon Grocery" 

ShipAddress="2817 Milton Dr." 

ShipCity="Albuquerque" ShipPostalCode="87110" 

ShipCountry="USA"> 

<Customers CompanyName="Rattlesnake Canyon 
Grocery" Address="2817 Milton Dr." 
City="Albuquerque" Country="USA" 

PostalCode="87110"/> 

</Orders> 

</document> 



IL TIPO DI OUTPUT 

C'è poi da dire che l'output in SQL Server 2000, 
era necessariamente una stringa di lunghezza 
massima di 4000 caratteri, se il documento risul- 
tante fosse stato più lungo la query avrebbe sud- 
diviso il testo tra in più righe che noi, in fase di 
lettura con un DataReader, avremmo dovuto 
ricomporre in un'unica stringa prima di interpre- 
tarne il risultato, come avviene in questa funzio- 
ne che restituisce una stringa, dove la variabile 
reader rappresenta un oggetto SqlDataReader : 

Public Function ReadForXml(ByVal reader As 
SqlDataReader, Optional ByVal RootName As String = 
"DocumentElement") As String 
Dim sb As New System. Text.StringBuilder 
sb.AppendFormat("<{0}>", RootName) 
While reader.Read 

sb.Append(reader.GetSqlString(0)) 

End While 

reader.Close() 



sb.AppendFormat("</{0}>", RootName) 
Return sb.ToString 
End Function 

Sql Server 2005, invece, ha XML come proprio 
dataType, quindi è possibile estrarre i dati 
direttamente come type XML specificando 
l'opzione TYPE nella clausola FOR XML come 
in: 

SELECT TOP 10 

from Orders 

innerjoin Customers 

ON Orders. CustomerID=Customers.CustomerID 

ORDER BY Orders.orderdate DESC 

FOR XML AUTO, TYPE, ROOTCdocument') 

In questo caso basta richiamare il metodo 
ExecuteXmlReader dell'oggetto SqlCommand 
per ottenere direttamente un XmlReader: 

Dim reader As XmlReader = cmd. ExecuteXmlReader 

Le innovazioni apportate alle query in XML da 
Sql Server 2005 sono molte altre, dalla possibi- 
lità di nidificare le clausole FOR XML a quella di 
specificare uno schema XSD, ma passiamo ora 
direttamente a risolvere il nostro problema ini- 
ziale: tabella ordini e dettaglio fattura. 




MODALITÀ EXPLICIT 



Un'illustrazione completa delle 
query SQL con la clausola FOR 
XML EXPLICIT richiederebbe un 
intero articolo. Al tempo 
stesso, dopo aver 
familiarizzato con il costrutto 
FOR XML in modalità AUTO o 
RAW, sentirete ben presto 
l'esigenza di un maggior 



controllo sull'output XML che 
riuscirete ad ottenere solo con 
EXPLICIT. 

Per fortuna l'opzione è ben 
documentata nella 
documentazione di Sql Book 
Online che viene distribuita da 
Microsoft insieme a Sql Server, 
in tutte le versioni. 



LA MOSTRA 
APPLICAZIONE 

In Visual Studio 2005 (anche Express) creiamo 
un nuovo progetto Web dove inseriremo due 
nuove pagine ASP.NET default.aspx (tabella 
ordini) e fattura.aspx (dettaglio fattura). 
Creiamo anche un nuovo file di codice, che 
chiameremo common.vb. 
Per questo esempio, infatti, sarà sufficiente 
scrivere il nostro codice condiviso in com- 
mon.vb che poi può essere incluso nelle pagi- 
ne ASP.NET attraverso il tag script in questo 
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modo: 

<script runat= "server" src="common.vb"x/script> 

Questo ci eviterà di dover scrivere lo stesso 
codice per ogni pagina. Da ricordare che il 
codice che inseriamo in common.vb è già nel 
contesto della pagina e quindi non dovrà 
essere inserito in una dichiarazione di classe. 
Il meccanismo di funzionamento del pro- 
gramma sarà il seguente: 

1. lettura del testo della query da un file su 
disco 

2. esecuzione della query per ottenere un 
documento XML 

3. trasformazione del documento XML con 
un foglio di stile XSL anch'esso salvato su 
disco per ottenere una stringa 

4. assegnazione della stringa risultante ad un 
controllo DIV marcato come runat="ser- 
ver" 

Nel corpo di common.vb inseriamo una 
costante che rappresenta la stringa di connes- 
sione: 

Private Const CONNECTIONSTRING As String = "Data 

Source=localhost\SQLEXPRESS;Initial 

Catalog = Northwind integrateci Security=True" 



cmd.CommandType = CommandType.Text 
conn.Open() 



Dim reader As XmlReader = 



cmd.ExecuteXmlReader 



Dim doc As New XPathDocument(reader) 



conn.CloseQ 



Return doc 



End Function 



È da notare il parametro argsQ della funzione 
che ci consente di inserire nel corpo della 
query SQL dei segnaposto tipo {0} che saran- 
no sostituiti, da String. Format, dai valori pas- 
sati come argomenti. 

Sempre in common.vb scriviamo la funzione 
che si occupa di fare tutto il lavoro di trasfor- 
mazione : 

Private Function GetOutput(ByVal queryFilename As 
String, ByVal xsltFilename As String, ByVal 
ParamArray args() As String) As String 
Dim xslEngine As New XslCompiledTransform() 
xslEngine.Load(MapPath(xsltFilename), 

XsltSettings. Default, New XmlUrIResolver) 
Dim sb As New System. Text.StringBuilder 
Dim writer As New IO.StringWriter(sb) 
xslEngine. Transform(ReadXPathDocument(queryFilen 
me, args), Nothing, writer) 



Return sb.ToString 



End Function 



Naturalmente in ambiente di produzione 

sarebbe preferibile inserire il valore nel file di 

configurazione. 

La funzione che legge il file contenente la 

query su disco e ne ricava un documento XML 

sarà la seguente: 

Private Function ReadXPathDocument(ByVal 
queryFilename As String, ByVal ParamArray args() As 
String) As XPathDocument 
Dim conn As New 

SqlConnection(CONNECTIONSTRING) 



Dim cmd As SqlCommand 



conn.CreateCommandO 



Dim sqlText As String 



FilelO. FileSystem. ReadAIIText 
(MapPath(queryFilename)) 



cmd.CommandText = String. Format(sqlText, args) 



ASP.NET IM VISUAL STUDIO 



Visual Studio 2005 offre, a 
differenza della versione 2003, 
il pieno supporto allo sviluppo 
di pagine con codice inserito 
direttamente nel tag <script>, 
offrendo anche in questo caso 



tutte le funzionalità di 
intellisense. Questa è stata una 
novità salutata con favore 
dagli sviluppatori provenienti 
da ASP classico abituati a 
lavorare con il codice "inline". 



In pratica, carica in un oggetto XslCompiled 
Transform il file XSLT da disco, recupera i dati 
con la funzione ReadXPathDocument che 
abbiamo visto prima e, infine, restituisce 
come stringa il risultato della trasformazione. 
A questo punto scriviamo il testo delle query 
in due files : Ordini. sql e Fattura. sql (trovate il 
testo, piuttosto lungo, nell'esempio allegato al 
ed). 

Il codice delle pagine ASP.NET è davvero 
minimo, vediamo quello di default. aspx: 

<%@ Page Language="VB" %> 

<script runat="server" src="common.vb"x/script> 

<script runat="server"> 

Protected Sub Page_Load( ByVal sender As Object, 
ByVal e As System. EventArgs) 
tablePlaceHolder.InnerHtml = 

GetOutput("Ordini.sql", "Ordini. xsl") 
End Sub 
</script> 



<html> 



<headxtitle>Ordini</titlex/head> 



<body> 



<div id="tablePlaceHolder" 



runat="Server"x/div> 



</body> 
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</html> 

In pratica si richiama, nel gestore dell' evento 
Load della pagina, la funzione GetOutput pas- 
sando il nome del file con la query SQL e quel- 
lo del file XSL. 

Tutta la logica di trasformazione, a questo 
punto, si sposta sul file XSL che trasforma l'in- 
put XML ricevuto da SQL Server. 
Vediamo, ad esempio, il punto saliente del file 
Ordini.xsl lì dove si crea la riga della tabella 
Ordini: 

<xsl:stylesheet version = "1.0" 

xmlns:xsl = "http://www.w3.org/1999/XSL/Transform" 



<xsl:template match = "row"> 

<tr class="row" 
onmouseover="this.className='rowSer" 
onmouseout="this.className='row"' 
onclick="window.open('fattura.aspx?OrderId = {@Ord 

rID}')"> 

<tdxxsl:value-of 

select="@OrderID"/></td> 
<tdxxsl:value-of 
select="@CompanyName"/x/td> 

<td> 

<xsl:value-of 
select="@Address"/> <xsl:value-of 
select="@ShipPostalCode"/> - <xsl:value-of 
select="@City"/> 



(<xsl:value-of 
select="@Country"/>) 


</td> 


<td align = "right"xxsl:value-of 
select="@0rderDate7></td> 


</tr> 


</xsl:template> 




</xsl:stylesheet> 



Notiamo che abbiamo fatto in modo, utiliz- 
zando Javascript, che la fattura si apra con un 
clic sull'intera riga e che è stato implementa- 
to un effetto mouseover sulla riga, cose che ... 
provatevi a fare con una DataGrid! 



IL RISULTATO 

Una volta preparate le query e i fogli di stile, 
non resta che azionare il famoso F5 dall'am- 
biente di sviluppo per far partire il web server 
integrato e il browser alla pagina default. aspx. 
Vediamo quindi il riepilogo ordini (figura 3) 
con le righe cliccabili che azionano un pop- 
up con il dettaglio della fattura (figura 4) 



OE 



sn 



File Modifica Visualizza Preferiti Strumenti 



l-ln|x 



Preferiti Q | - .,. [ 



J Indirizzo |.è] httpi/i'IO'Zalhoit: l^/Esempioit'efault.-Kp ■ 

j Googk^ | _;J||C Cerca - g] Popup OK *f Ortogr afia ^ §j Opzioni ._>■ 



Ordine 



Indirizzo cliente 



11077 
11076 
11075 
11074 
11073 
11072 
11071 
11070 
11069 
11068 



Rattlesnake Car i Grece 281/ M . i buquerque (U 



Bon app' 

Richter Supermarkt 

Simons bistro 

Pericles Comidas clàsicas 

Ernst Handel 

ULA-Supermercado 

Lehrnanns Marktstand 

Tortuga Restaurante 

Queen Cozinha 



12, me des Boli e! L300 M illeiFrance) 

Grenzacherweg 2371204 - Genève (Switzerland) 

, » basii ) Dbenhavn (Dennnark) 

Calle Dr.Jorge '-, li L0503E Me ira D.F, (Mexico) 

! il digasse 68010 - Graz (Austria) 

Carrara 52 con Ave, Bolivar #65-98 Uano Largo3508 - Barquisimeto (Venezuela) 

Magazinweg 760528 - Frankfurt a.M, (Germany) 

Avda. Azteca 12:305033 - Menico D.F. (Mexico i 

Alarneda des Canarios, 89105487-020 - 3ao Paulo i.Brazil) 



1998 -05- 
1998-05- 
1998-05- 
1998-05- 
1998-05- 
1998-05- 
1998-05- 
1998-05- 
1998-05- 
1998-05- 



-06T00:00:00 


-06TOO:00:00 


-06T00:00:00 


-06T00:00:00 


-05TOO:00:00 


-05T00:00:00 


-05T00:00:00 


-05TOO:00:00 


-04T00:00:00 \ 


-04T00:00:00 


| 





Operazione completata 



Intranet locate 



Fig. 3: Riepilogo ordini 
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1* 




'S@ l\ z 1 ' Cerca A Preferiti @ - | | > ^ , H ' ■ 






\ 


ndirizzo http : //iocalhost : L 58'1 /Esempio/fattura . asp ;■: ?OrderId= i ! 076 




*l 


\ GGQgle - | .il | d Cerca - $ gì Popup OK *3r Ortografia - g Opzioni 


J 


J Collegamenti w 




FATTURA: 11076 Spettile 

Bori app' 

12 ; me des Botici" 
13008 -Marseille 
Fra n ce 


ers 




-1 




Prodotto Prezzo 


Quantità 


Totale 




Grandma's Boysenberry Spread 

Tofu 

Teatime Chocolate Biscuits 


25,00 
23,25 
9,20 


20 
20 
10 


500,00 
465,00 
92,00 




57,45 


50 


2.872,50 










d 


Operazione completata 


|*-j Intranet locale 



Fig. 3: Dettaglio fattura 



CONSIDERAZIONI FINALI 

XM1 è uno strumento che ha già qualche anno 
di vita e molte delle applicazioni moderne ne 
fanno uso. Non a caso SQL Server 2005 integra 
nativamente le estensioni per XML. Il poter 
ottenere i risultati di una Query direttamente 
in questo formato, fa si che molto dell'even- 
tuale lavoro di trasformazione sia demandato 
direttamente al server, con la logica conse- 
guenza di una netta diminuizione del numero 
di righe di codice, e di eventuali errori. E 
Da prove effettuate, la trasformazione diretta 
SQL/XSL si è rivelata dal 10% al 50% più velo- 
ce rispetto all'utilizzo del controllo DataGrid, 
un buon motivo per approfondire questa tec- 
nica che, inoltre, lascia piena libertà allo svi- 
luppatore nel controllo dell'output prodotto. 

Francesco Smelzo 
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COME POSSO VISUALIZZARE UN 
FILMATO IN .NET 

LA COSA PIÙ SEMPLICE È PASSARE ATTRAVERSO LE DIRECTX. VEDIAMO COME. 



VISUAL BASIC.NET 



I FACCIAMOLO IN C# 

Su una forni posizioniamo tre bottoni, un 
pannello e un componente OpenFileDialog 




I Usiamo il menu "aggiungi riferimento" per 
i poter utilizzare le DirectX 



▼ X 




Lf 




o. £ m ^ 


==== 


GB- 0^1 Prof 


Aggiorna 


H- j^ Ref 
Q- |=1] For 

! <B 

1 ti 

! °Ì Pro 




Genera 
Rigenera 
Pulisci 
Pubblica,,. 




Aggiungi ► 


Aggiungi riferimento, . , 


* 

ì 


Aggiungi riferimento Web,., 


Visualizza diagramma classi 


Debug ► 


Taglia 
Incolla 
Rinomina 




Proprietà 


i2 1 f button3 1 







l Dalla finestra che compare selezioniamo 
) "Microsoft AudioVideoPlayback" 



■ NET COM Progetti Sfoglia Recente 



Nome componente <*> 


Versione 


Runtime 


Percors A 


Microsoft. Build, Visual JSharp 


2,0,0,0 


v2. 0,50727 


C:\WINI 


Microsoft. Con ork. Build. Tasks 


8,0,0,0 


v2. 0,50727 


C:\WINI 


Microsol i .DataWarehoi ise.Interf aces 


9,0,242,0 


v2. 0,50727 


c:\Progr 


Microsoft. DirectX 


1,0,2902,0 


vi. 1,4322 


C:\WINI 


ifflnaigHHiaiwiiaagsiBawsiiHMBiaflffl^BJ 


Microsoft. DirectX. Diagnostics 


1,0,2902,0 


vi. 1,4322 


C:\WINI 


Microsoft. DirectX. Direct3D 


1,0,2902,0 


vi. 1,4322 


C:\WINI 


Microsoft. DirectX. Direct3DX 


1,0,2906,0 


vi. 1,4322 


C:\WINI 


Microsoft. DirectX. DirectDraw 


1,0,2902,0 


vi. 1,4322 


C:\WINI 


Microsoft. DirectX. Directlnput 


1,0,2902,0 


vi. 1,4322 


C:\WINI 


Microsoft. DirectX. Dir ectPlav 


1,0,2902,0 


vi. 1,4322 


C:\WINI 


Microsoft. DirectX. Dir ectSound 


1,0,2902,0 


vi. 1,4322 


C:\WINI 


Microsoft. JScript 


8,0,0,0 


v2. 0,50727 


C:\WINI 


Microsoft. mshtml 


7,0,3300,0 


vl.0.3705 


C:\Prog 


Microsoft. ReportVie'A'er. Common 


8,0,0,0 


v2. 0,50727 


C:\Prog v 


■I^^^^^^HD^H 






> 



Aggiungiamo un oggetto privato di classe video 



private Video _video; 

5 clicchiamo due volte nel buttone uno per 
implementare il codice relativo all'evento 
onclick 



if (openFileDialogl.ShowDialogQ 



DialogResult.OK) 



int height = panell.Height; 



int width = panell.Width; 



_video = new 

Video(openFileDialogl.FileName); 



_video.Owner =panell; 



panell.Width = width; 



panell.Height = height; 



_video.Play(); 



» Programmiamo anche il pulsante due che deve 
) mettere in pausa il video 



private void button2_Click 

(object sender, 


EventArgs 


e) 


{ 


_video.Pause(); 


} 



■Possiamo anche programmare il pulsante tre 
per far si che in seguito alla sua pressione il 



video venga riprodotto 



private void button3_Click 

(object sender, 


EventArgs 


e) 


{ 


_video.Play(); 


} 



COME FUNZIONA? 

A fare quasi tutto il lavoro sono le DirectX. Nella 
parte iniziale aggiungiamo un riferimento per 
poterle utilizzare all'interno del nostro progetto. 
Il codice è poi abbastanza semplice, è sufficiente 
creare un container in cui proiettare il video per 
poi programmare i vari pulsanti tramite i metodi 
appropriati. Creiamo un nuovo oggetto di classe 
_video f gli assegnamo come owner un panel. 
Utilizziamo il metodo play per proiettare il video 
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nel pannello, altri metodi possibili sono ad esem- 
pio lo stop o il rewind. 

^SFACCIAMOLO CON 
VISUAL BASIC 

1i passi da uno a tre rimangono sostanzialmente 
identici. La dichiarazione dell'oggetto video 
invece diventa 

Dim _video As Video 

^ Il bottone play diventa 



Private Sub Buttonl_Click(ByVal sender As 

System.Object, ByVal e As System. EventArgs) 
Handles Buttonl. Click 
If (OpenFileDialogl.ShowDialogO = 

DialogResult.OK) Then 
Dim height As Integer 
Dim width As Integer 
_video = New 

Video(OpenFileDialogl.FileName) 
width = Panell. Width 



height = Panell. Height 



Panell. Height = 


= height 


_video.Play() 


End If 


End Sub 



>I1 bottone play diventa 



Private Sub Button3_Click(ByVal sender As 

System.Object, ByVal e As System. EventArgs) 
Handles Button3. Click 
_video.Play() 
End Sub 



_video.Owner = Panell 



I II bottone pause diventa 



Private Sub Button3_Click(ByVal sender As 

System.Object, ByVal e As System. EventArgs) 
Handles Button3. Click 
_video.Pause() 
End Sub 

DOVE POSSO TROVARE LE 
DIRECTX ? 

Perché tutto funzioni avrete dovuto installare le DirectX 
almeno nella versione 9. Potete scaricarle all'indirizzo 
http://msdn.microsoft.com/directx/sdk 



Panell. Width = width 



COME POSSO CREARE ISTANZE 
A RUNTIME? 

IMPLEMENTIAMO UNA CLASSE BASE. CREEREMO TUTTE LE ALTRE DERIVANDOLA DA QUESTA 
E INSTANZIANDOLA CON UN METODO EXECUTE GENERICO 



Talvolta abbiamo la necessità di utilizzare 
delle classi di cui non conosciamo la posizio- 
ne in fase di sviluppo. In questo caso dobbia- 
mo implementare un sistema che ci garanti- 
sca una tipizzazione, ma anche la possibilità 
di creare istanze a runtime. Vediamo come 
implementare un piccolo sistema di plug-in 
utilizzando Visual Basic 2005. Il nostro siste- 
ma utilizzerà una classe base IoBase che 
tutte le classi non conosciute dovranno 
implementare. IoBase avrà il solo metodo 
Createlnstance. 

^SFACCIAMOLO CON 
VISUAL BASIC 

1 Creiamo un nuovo progetto Console 
Application utilizzando il linguaggio Visual 
Basic .NET 




Business intelligence F'rojects 
Visual C# 
Other Languages 
S • Visual Basic 
: ■■ Windows 
+ Smart Device 
Starter Kits 
H-VisualJ* 
H- Visual C++ 
Q- Other Project Types 

Setup and Deployment 
:■■■ Extensibility 
Visual Studio Solutions 



Windows Application 
Console Application 
Web Contro: Library 

My Templates 



Windows Control Library 
[ite] Empty Project 



IpSearch Online Templates. . . 



A project fot creatina a V6 class library ! '..d!i) 



Location: 



| ClassLibraryl 



I C:\Documen - * "-li i fai i ie i.Visual S liei 2u05\Prajeci 



Solution Name: ClassLibraryl 



Create directory fcr solution 



(Aggiungiamo una classe, la chiamiamo 
i IoBase.vb 
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_ 


1 Solution 'ClassLibraryl' (1 project) 






m 


Refresh 






ÌH Build 
Rebuild 
Clean 




J New Itern. . . 


Add * 


-'4 Existing Itern... 
_j New Folder 


A 

A 


Add Reference... 
Add Web Reference, . , 
View Class Diagram 
Set as StartUp Project 
Debug ► 


] Windows Form... 
| User Control... 


qj] Component... 
'] Module... 


Cut 
Remove 


J Class... 


X 




lì 



arrayType = strType.Split(",") 



^ Debug - Any CPU 


T _*$ SendPci 


* 


— *- » \ìi 






• 1 X Classl.vb Start Page 


* n 


" 


(General) 


jj(Declarations) 


lemplates: 


a 


Visual Studio installed templates 

1 Windows Form J Dialog 
_j| MDI Parent Form J About Box 

~, Splash Screen *fej Class 
;^ Interface J] Component Class 
^jDataSet ( SQL Database 
User Control |Inherited Form 
j/f Custom Control $À Web Custom Control 
_] Settings File V) Code File 
■J\ XML File ij XML Schema 
g\ Text File j HTML Page 
t* Cursor File _] Icon File 
^1 Transactional Component ,^1 Installi. 


n Explorer Form 
_ 1 Login Form 
m Module 
; ^ COM Class 
j^ Report 
jlnherited User Control 

Resources File 
^ Class Diagram 
'jj* XSLT File 
jj Bitmap File 
_] Application Configuration File 

Windows 


~ 
- 


An empty class definition 








Name : AuthenticationMailMessage.vb| 


1 












Add | Cancel 







3 e la dichiariamo come Mustlnherit (abstract in 
C#). 

Public Mustlnherit Class IoBase 
End Class 

4 Inseriamo anche l'unico metodo della 
classe, il metodo Execute 

Function execute() 
End Function 

5 Inseriamo il metodo Createlnstance e lo 
dichiariamo shared (static in C#): 

Public Shared Function Createlnstance() As 

IoBase 



Dim asm As Assembly 



Dim strType As String 



Dim arrayTypeQ As String 



strType = 
ConfigurationManager.AppSettings("CurrentClass") 
If (strType. IndexOf(",") > 0) Then 



strType = arrayType(O) 



Assembly. Load(arrayType(l).Trim()) 



Else 



Assembly.GetExecutingAssemblyO 



End If 



Return 
CType(asm.CreateInstance(strType), IoBase) 

6 il metodo Createlnstance richiede la pre- 
senza nel file di configurazione di una 
chiave CurrentClass che indica qual è il tipo 
da istanziare ed eventualmente in che 
assembly si trova: 

<configuration> 

<appSettings> 
<add key="CurrentClass" 
value="ioProgrammo.FirstClass, ioProgrammo"/> 

</appSettings> 
</configuration> 

Il tipo ioProgrammo.FirstClass si trova nel- 
l'assembly ioProgrammo. Il codice soprain- 
dicato legge il valore e verifica la presenza 
del nome deH'assembly Se trovato esegue lo 
split della stringa e crea la relativa istanza, 
altrimenti recupera l'istanza delFassembly 
corrente 

7 l'implementazione del client sarà simile a 
questa: 



Dim io As IoBase 



IoBase. CreatelnstanceQ 



Dim s As String = io.Execute() 

Semplicemente modificando il tipo e l'as- 
sembly indicati nel .config possiamo sosti- 
tuire la classe inizialmente dichiarata con 
un'altra che implementa sempre la classe 
base IoBase. 



COME FUNZIONA? 

È abbastanza semplice. Le informazioni relative alla 
classe vengono tratte dal file XML. Il file viene par- 
serizzato alla ricerca del parametro CurrentrClass, se 
lo trova splitta la stringa e crea l'istanza. Il metodo è 
abbstanza comodo quando si devono creare classi 
rapidamente senza manipolare il codice, la funzione è 
quella di creare una factory abbastanza dinamica 
senza troppi problemi di programmazione modifican- 
do esclusivamente il file contenente la definizione 
delle classi 
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COME POSSO INVIARE MESSAGGI 
E-MAIL CON AUTENTICAZIONE? 

NELLA VERSIONE 1.1 DEL FRAMEWORK È RELATIVAMENTE SEMPLICE PREPARARE ED INVIARE 
MESSAGGI EMAIL MA È UN PO MENO FACILE GESTIRE LE MODALITÀ DI AUTENTICAZIONE 
SUL SERVER SMTP. VEDIAMO COME È POSSIBILE FARLO UTILIZZANDO VISUAL BASIC .NET. 



I FACCIAMOLO 
CON VISUAL BASIC 

1 Creiamo un nuovo progetto Visual Basic Class 
Library 




j Aggiungiamo la classe 

■ AuthenticationMailMessage.vb 




- I W*fl - «*<*J 




MJj"v: 



Hnlnr 


Mi*xm<:bm 




!l> r.w<h« 


jw jyr-j 


-Mw&dRm 


■ JS>f ..*'••<> 


■Tt-.UjfV^ «T*-y 


jm^M* 


.||»M. 


«m 


ìHHw 


M '■■•'. 


. HTM.PW 


',„.•,*,'* 


:.....** 


.■.«intoni ™pi»rt 


1-** *- ■: iwc 



i *M II Cwi I 



I Inseriamo il seguente codice: 



Public Class AuthenticationMailMessage 
Inherits MailMessage 
Public Property WriteOnly Credentials As 
System . Net. NetworkCredentials 

Set 

MyBase.Fields("http://schemas. microsoft.com/cdo/ 

onfiguration/smtpauthenticate") = 1; 
MyBase.Fields("http://schemas. microsoft.com/cdo/ 

onfiguration/sendusername") = value.UserName; 
MyBase.Fields("http://schemas. microsoft.com/cdo/ 
onfiguration/sendpassword") = value. Password; 

End Set 

End Public 
End Public 



il primo parametro imposta il tipo di 
autenticazione. I possibili valori sono: - nessuna, 
1-Basic,2-NTLM. 



I Utilizziamo ora la classe per l'invio di un 
P messaggio e-mail: 



Imposto il messaggio e-mail da inviare 



Dim mail As New AuthenticationMailMessage() 
mail.From = "fabio@dotnetside.org" 
mail.To = "fabio@dotnetside.org" 
mail.Subject = "Prova di un messaggio e-mail" 
mail. Body = "Questo è un messaggio e-mail di 

prova." 
1 Imposto le credenziali per l'invio 
mail. Credentials = New 

System. Net. NetworkCredentials("username" 

"password") 
x Imposto il server smtp e invio il messaggio 

SmtpMail.SmtpServer = "mail.server.com" 
SmtpMail.Send(mail) 

In questo modo garantiamo l'autenticazione per 
l'invio di e-mail anche per quei server che lo 
richiedono. Il funzionamento è e hiaro, tutto è 
demandato al metodo Credentials, che riceve 
username e password e provvede ad inviare le aL 
server le informazioni con le credenziali corrette 
per l'autenticazione 
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SQL SERVER 2005 
SERVICE BROKER 

SI TRATTA DI UNA DELLE FUNZIONALITÀ PIÙ INNOVATIVE NELLA NUOVA VERSIONE DEL DB 
DI MICROSOFT IMPLEMENTA UN SISTEMA DI MESSAGISTICA BASATA SU CODE, FRA SERVER. 
VEDREMO COME SFRUTTARE QUESTA CARATTERISTICA PER LE NOSTRE APPLICAZIONI 





REQUISITI 



■ iii'i ' li ii'i ^m 

~ SQL Server 2005, T-5QL 



t 



SQL Server 2005 



00 



Tempo di realizzazione 



Il nostro problema di oggi è semplice. Abbia- 
mo mandato in giro per l'Italia i nostri agen- 
ti di vendita. Li abbiamo equipaggiati con 
un notebook e una fantastica applicazione che 
consente di registrare gli ordini in un database. 
Ora, va da sé che se ciascun notebook utilizza 
un suo database, la nostra azienda non avrà mai 
una visione globale degli ordini registrati dagli uten- 
ti. Abbiamo bisogno di un database centrale, in 
cui riversare i dati prelevati dai singoli database 
degli agenti. Il problema non è semplice, per- 
ché i nostri agenti possono star fuori anche qual- 
che giorno prima di tornare in sede e ovviamente 
non dispongono perennemente di una connes- 
sione internet, per cui non possono inviare i da- 
ti in tempo reale al server centrale. Devono ne- 
cessariamente immagazzinarli in un DB inter- 
no per poi scaricarli sul DB centrale alla prima oc- 
casione utile. Come fare? Ci viene in aiuto "Ser- 
vice Broker". Si tratta di un servizio di "messag- 
gistica" asincrona implementato in Microsoft 
SQL server 2005. In sostanza il nostro problema 
sarà risolto in questo modo. Sul notebook del 
cliente installeremo SQL Server express edition, 
che come tutti sanno è gratuito ed è più che suf- 
ficiente per le esigenze del singolo agente. Il no- 
stro server remoto sarà invece un SQL Server 
2005 standard edition. Quando l'agente salverà 
i dati, in realtà li "ingloberà" in un messaggio 
XML che sarà conservato in una coda nel data- 
base interno. Alla prima disponibilità di con- 
nessione, il messaggio contenente il dato da sal- 
vare sarà inviato al server centrale che lo rice- 
verà e lo elaborerà inserendo il dato. Tutte le mo- 
dalità per lo scambio di messaggi sono imple- 
mentate in un servizio denominato "Service 
Broker". Ovviamente è possibile scambiare mes- 
saggi di qualunque tipo, quindi al di là del sem- 
plice esempio che abbiamo proposto per ren- 
dere immediata la comprensione dell' argomento, 
vedremo che un servizio di messaggistica inter- 
no a SQL server può essere utilizzato in più di 
una occasione. 



SERVICE BROKER 
ll\l PROFONDITÀ 

È una delle novità più interessanti introdotte da SQL 
Server 2005. Come già detto si tratta di un sistema per 
lo scambio asincrono di messaggi tra servizi. Quando 
un'applicazione invia un messaggio ad un servizio, 
Service Broker lo inserisce in una coda associata al 
servizio di destinazione che lo leggerà quando avrà 
risorse. I messaggi possono essere inviati e ricevuti 
dallo stesso database, da database diversi o anche da 
database remoti. 

Service Broker consente a due endpoint di comunicare 
grazie ad un protocollo chiamato Dialog che gestisce 
la comunicazione asincrona e garantisce il corretto 
ordine di ricezione dei messaggi utilizzando delle 
estensioni di T-SQL per la gestione delle code. 
Service Broker ha un'architettura a livelli. In cima al- 
la pila, a livello applicativo abbiamo due entità che 
vogliono scambiarsi messaggi. 
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Fig. 1: Architettura di Service Broker 

Pensate ad esempio ad un negozio online che riceve 
molti ordini. Piuttosto che salvare tutti i dati imme- 
diatamente nel server, gli ordini potrebbero essere 
immagazzinati un una coda ed elaborati sequenzial- 
mente. In questo caso i nostri endpoint sarebbero il ne- 
gozio on-line e lo Storage server. 
Abbiamo poi un livello intermedio, detto dei 
meta-dati, che serve a descrivere le modalità 
con cui le applicazioni parlano (i tipi di mes- 
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saggi che possono scambiarsi ed in che moda- 
lità possono farlo). 

Il livello più basso, quello fisico, si occupa del 
trasporto e deiraccodamento dei messaggi. 
Vediamo in dettaglio i componenti principali 
dell'architettura di Service Broker. 




Fig. 2: I livelli di trasporto 



COME SONO 
STRUTTURATI 
I MESSAGGI? 

I messages sono le entità che vengono inviate con 
Service Broker. Ogni messaggio fa parte di una 
conversation. Possiamo inviare diversi tipi di 
messaggio come ad esempio XML o in formato 
binario. Quello che è possibile inviare viene de- 
finito tramite la creazione di Message Types. 

Per creare un message type utilizziamo la se- 
guente sintassi: 



CREATE MESSAGE TYPE nome_del_message_ 


_type 


[ AUTHORIZATION nome_proprietario ] 


[ VALIDATION = 


{ NONE 


| EMPTY 


| WELL_FORMED_XML 


| VALID_XML WITH SCHEMA COLLECTION 


II_nome_dello_schema_collection 


}] 



eseguire quando il messaggio viene letto e prò- f 

cessato. 

Per definire una coda 



CREATE QUEUE 

nome_database.nome 


_schema 


nome. 


_coda 


[ WITH 


[ STATUS = { ON | OFF } [ , 


] ] 








[ RETENTION = { ON | OFF } [ , 


] ] 






[ ACTIVATION ( 


[ STATUS = { ON | OFF } 


,] 









PROCEDURE_NAME = 

la_stored_prcedure_da_usare , 
MAX_QUEUE_READERS = 

numer_massimo_di_readers , 
EXECUTE AS { SELF | 'nome_utente' | 

OWNER } 
)] 



] 



[ ON { nome_filegroup | [ DEFAULT ] } ] 



CHI INVIA E RICEVE 
I MESSAGGI? 

I service sono utilizzati da Service Broker per 
inoltrare i messaggi alla relativa coda nel data- 
base. Un service program è l'entità che proces- 
sa i messaggi; viene attivato quando arriva un mes- 
saggio dalla coda. A ciascun service è associato 
un contract, in modo che i messaggi possano 
essere validati. 

La sintassi è la seguente: 

CREATE SERVICE nome_service 

[ AUTHORIZATION nome_proprietario ] 
ON QUEUE [ nome_schema. ]nome_coda 
[ ( nome_contract | [DEFAULT] [ ,...n ] ) ] 




Ciascun servizio "espone" un contract che de- 
finisce quali tipi di messaggi sono consentiti, 
chi può inviarli e chi può riceverli. La sintassi: 

CREATE CONTRACT nome_contratto 
[ AUTHORIZATION nome_proprietario ] 
( { { nome_message_type | [ DEFAULT ] } 

SENT BY { INITIATOR | TARGET | ANY } 
} [,-..n]) 



MESSAGGISTICA 
DISTRIBUITA 

Le routes, sono utilizzate da Service Broker per 
capire dove inoltrare i messaggi nel caso in cui 
si utilizzino dei servizi di messaggistica distribuiti. 
Per creare una rotta occorre specificare: il ser- 
vizio che utilizzerà la rotta, l'indirizzo ed il pro- 
tocollo da utilizzare. InT-SQL 



CREATE ROUTE nome rotta 



WITH 



COME SONO 
STRUTTURATE LE CODE? 

Le queues servono ad immagazzinare i mes- 
saggi in arrivo, sono associate ad un service pro- 
gram che rappresenta una stored procedure da address = 'indirizzo' 



[ AUTHORIZATION nome_ proprietario] 



[ SERVICE_NAME = 'nome_service', ] 

[ BROKER_INSTANCE = 'identificatore_istanza' , ] 



[ LIFETIME = tempo_di_vita , ] 
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SECURITY 

Service Broker 

fornisce meccanismi 

di sicurezza a livello 

di dialogo 

e di trasporto. 

A livello di dialogo, 

cripta i messaggi e 

verifica le identità dei 

partecipanti. A livello 

di trasporto, stabilisce 

una connessione 

autenticata tra due 

entità in modo da 

prevenire accessi non 

autorizzati. 



[ , MIRROR_ADDRESS = 'indirizzo_mirror' ] 

Un dialog è una conversazione tra due endpoint: 
Finitiator, il target.vPerché la conversazione av- 
venga è necessario specificare il contract che 
verrà utilizzato per conversare. Una conversa- 
tion group è un insieme di dialogs. Il transport 
è il protocollo sottostante che permette a due 
endpoint di comunicare. E' un protocollo pro- 
prietario nativo di SQL Server 2005. 



METTIAMO 
TUTTO INSIEME 

Per utilizzare Service Broker occorre creare una 
serie di componenti necessari per il funziona- 
mento del sistema. Innanzitutto, occorre crea- 
re dei message type, ovvero i tipi di messaggio 
che due endpoint potranno scambiarsi. E' ne- 
cessario poi definire come avverrà la conversa- 
zione tramite un contract. Quindi, devono essere 
realizzate le queue per contenere i messaggi in- 
viati durante la conversazione. Creati gli og- 
getti base dell' architettura, possiamo definire i 
services che permetteranno di scrivere e legge- 
re dalle code. A questo punto, siamo in grado 
di iniziare un dialog tra due entità di Service 
Broker che prendono il nome di Initiator e Tar- 
get. 



lAIrUAM 



l 



Initiator 
Endpoint 



Target 
Endpoint 



Dialog 



I 



Fig. 3: Le fasi di creazione di una conversazione 



— trustworthy deve essere impostata ad on per usare 

Service Broker 
ALTER DATABASE TestServiceBroker SET trustworthy 

ON 

_go 

—Occorre creare una master key 

CREATE MASTER KEY ENCRYPTION BY PASSWORD = 



'MorpheusWeb2006' 



go 



Il message type 



CREATE MESSAGE TYPE myMessage 



go 



Il contract 



CREATE CONTRACT myContract(myMessage SENT BY 

ANY) 



go 



Creiamo le code per invio e ricezione dei messaggi 



CREATE QUEUE SenderQueue 



CREATE QUEUE ReceiverQueue 



go 



I services per inviare e ricevere 



CREATE SERVICE SenderService ON QUEUE Sende 

Queue 
CREATE SERVICE ReceiverService ON QUEUE 

ReceiverQueue (myContract) 

go 

— Lanciamo la query in un'altro query browser, 
—resterà in attesa dell'arrivo di messaggi in coda 
WAITFOR (RECEIVE TOP(l) 

CAST(message_body as XML) 

FROM ReceiverQueue); 

go 



— Torniamo alla precedente finestra ed inviamo dei 

messaggi 

— creiamo un dialog con un id di conversazione 

ed inviamo dal servizio sender al receiver. 

— Quando abbiamo inviato tutti i messaggi 

terminiamo la conversazione 
DECLARE @id uniqueidentifier 
BEGIN DIALOG CONVERSATION @id 
FROM SERVICE SenderService TO SERVICE 'Receive 

Service' 
ON CONTRACT myContract; 



IL CLASSICO 
"HELLO WORLD" 

Mettiamo subito in pratica quello che abbiamo 
imparato con un semplice esempio di invio /ri- 
cezione messaggi. Possiamo eseguire le query 
a blocchi (fino ad ogni istruzione "go" per ve- 
dere cosa succede). 

—creiamo il database di test 
CREATE DATABASE TestServiceBroker 

Jjo 

USE TestServiceBroker 

go 



l * [or . - 

*■ v r 
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Fig. 4: La ricezione del messaggio 
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SEND ON CONVERSATION @id MESSAGE TYPE m 

Message ('<msg>Ciao</msg>'); 
SEND ON CONVERSATION @id MESSAGE TYPE 

myMessage ('<msg>Carmelo</msg>'); 
SEND ON CONVERSATION @id MESSAGE TYPE m 

Message ('<msg>Come va?</msg>'); 
END CONVERSATION @id WITH CLEANUP; 
Go 



SQL SERVER 
MANAGEMENT STUDIO 

Nel caso di utilizzo di SQL Server Management 
Studio, abbiamo la possibilità di visualizzare i com- 
ponenti di Service Broker per ciascuno dei no- 
stri database. 
Sql Server Express non ha una gestione "visua- 






■j , l i l 



JiAj* &J&K 3,. 



J A ff iWi" 



^SS»*- « J Message Types 



, j HHU^I]^ 



_l Mntiir ìrrvirl*!! 



«V*i nh*H0 



J*Mip:f.l«twvn**.m 
yVnp:fJp^Vkfil^rtmQ£^^Mr^J>J'jHVB-J»cl>«i , ltnÌjirt..or*.. dm 

jft^:fM^nm.iikrairfljDmVSflW!*rrt*Bw(™fSnnvic*CI^... d» 
^p:fj K h™.m*TWt JH! VWS«™V*^ff*^^ dm 
*"" " ' 



F/g". 5: SQL Server Management Studio 

le" di Service Broker: possiamo comunque vi- 
sualizzare gli oggetti che ci interessano tramite 
delle view di sistema come: 

sys.service_message_types 

sys.service_contracts 

sys.service_contract_message_usages 

sys.service_contract_usages 

sys.service_queues 

sys.service_queue_usages 

sys. services 

sys.conversation_groups 

sys.conversation_endpoints 



F7" 
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F/gf. 6: / templates di SQL Server Magement Studio 



QUANDO USARE SERVICE BROKER 



Molte applicazioni che fanno uso 
dei trigger potrebbero utilizzare 
Service Broker per realizzare dei 
trigger asincroni. Il trigger 
potrebbe inserire un messaggio 
in coda invece di processarlo 
subito in modo da poter 
continuare la transazione 
evitando così di tenere aperta 
una transazione per troppo 
tempo. 

Possiamo usare Service Broker 
per la raccolta di dati, ad esempio 
delle filiali di una banca 
potrebbero inviare le 
informazioni sulle transazioni al 
server centrale, che le processerà. 

Oppure per grosse applicazioni 
che accedono a più database di 
SQL Server, come mezzo di 



interscambio di informazioni. 

Service Broker può essere 
utilizzato per implementare dei 
sistemi di elaborazione query in 
modo affidabile, 
indipendentemente da eventuali 
errori interruzioni di servizio, 
inserendo i messaggi da 
elaborare in una coda. I messaggi 
saranno poi processati quando si 
avranno risorse disponibili. 

O infine per operazioni di 
elaborazione batch su vasta 
scala. Un'applicazione potrebbe 
inviare i dati ad una coda di 
Service Broker mentre un'altra 
ne potrebbe leggere 
periodicamente il contenuto 
della coda per poi elaborare i 
dati. a 



ESEMPIO COMPLETO 

Consideriamo il seguente scenario: una società 
con una serie di filiali ed una centrale. 
Le filiali hanno il compito di registrare degli 
utenti sul database centrale. Le filiali comuni- 
cano con la centrale tramite Service Broker che 



Per visualizzare i message types, ad esempio, 
scriveremo 

SELECT * FROM sys.service_message_types 

SQL Server Management Studio contiene an- 
che molti template per la creazione di oggetti 
di Service Broker. Basta cliccare su "View"->"Tem- 
plate Explorer" per visualizzare la lista dei tem- 
plate disponibili per numerose funzionalità di 
SQL Server tra cui Service Broker. 



I 

I 

I 




Fig. 7: il nostro scenario 
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si occupa deiraccodamento delle richieste che 
verranno elaborate dal server. 
Creiamo il database, impostiamo la proprietà 
TRUSTWORTHY a ON e creiamo infine una ma- 
ster key (è necessario per l'utilizzo di Service 
Broker) 

CREATE DATABASE TestServiceBroker 
USE TestServiceBroker 

ALTER DATABASE TestServiceBroker SET TR 

STWORTHY ON 

CREATE MASTER KEY ENCRYPTION BY PASSWORD = 

'MorpheusWeb2006' 

Creiamo quindi la tabella utenti 

CREATE TABLE TestServiceBroker.dbo. Utenti 



( 



[idUtente] [int] IDENTITY(1,1) NOT NULL, 
[nome] [varchar](50) COLLATE Latinl_ 

General_CI_AS NOT NULL, 
[cognome] [varchar](50) COLLATE 

Latinl_General_CI_AS NOT NULL, 
[email] [varchar](50) COLLATE Latinl_ 

General_CI_AS NOT NULL, 
CONSTRAINT [PKJJtenti] PRIMARY KEY CLUSTERED 



( 



[idUtente] ASC 



)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY] 



) ON [PRIMARY] 



E due stored procedure che ci serviranno per 
inserire gli utenti 



CREATE PROCEDURE dbo.getXMLValue 
@xmlString XML, 
@xpath varchar(lOO) 



@value varchar(lOO) 



output 



AS 



DECLARE @Idoc int 



SETNOCOUNTON 



EXEC sp_xml_preparedocument @Idoc OUTPUT, 



SQL 2005 EXPRESS EDITION 



Chi utilizza SQL Server Express 
deve comunque avere almeno 
un'installazione di SQL Server 
2005. Questo perché in base alla 
licenza d'uso non è possibile che 
un messaggio arrivi da un SQL 
Express ad un altro Express senza 
che almeno un altro SQL Server 
(non Express) lo abbia 
processato. Se ciò dovesse 
succedere il messaggio andrebbe 
perso. 



Possiamo renderci conto di simili 
comportamenti utilizzando il 
Profiler; vedremmo dei messaggi 
del tipo: "This message has been 
dropped due to licensing 
restrictions". 
In una situazione reale 
potremmo pensare di utilizzare 
delle copie della versione Express 
come Database per dei front-end 
ed una versione non Express per 
il back-end di elaborazione dati. 



@xmlString 



SELECT @value = [text] FROM OPENXML (@Idoc, 

@xpath,l) 

La prima legge un XML ed estrae il testo associato 
ad un elemento, mentre la seconda: 

CREATE PROCEDURE dbo.Processalnformazioni 

©utente XML 
AS 



DECLARE @nomeUtente varchar(50) 

EXECUTE dbo.getXMLValue @utente, 'Utente/nome', 

@nomeUtente output 
DECLARE @cognomeUtente varchar(50) 
EXECUTE dbo.getXMLValue ©utente, 

'Utente/cognome', @cognomeUtente output 
DECLARE @emailUtente varchar(50) 
EXECUTE dbo.getXMLValue @utente, 'Utente/email, 

@emailUtente output 
INSERT INTO Utenti(nome, cognome, email) 
VALUES(@nomeUtente, ©cognome 

Utente, @emailUtente) 



utilizza dbo.getXMLValue per leggere nome, co- 
gnome ed email dall'XML 
La fase di setup del database è completata. Oc- 
corre adesso creare gli oggetti per lo scambio 
dei dati. 

Come prima cosa creiamo uno schema per la 
validazione del messaggio XML 

CREATE XML SCHEMA COLLECTION SchemaUtente 

AS 

'<?xml version="1.0"?> 
<xs:schema 

xmlns:xs= "http://www.w3.org/2001/XMLSchema"> 
<xs:element name="Utente"> 
<xs:complexType> 
<xs:sequence> 
<xs:element name="nome" type="xs:string"/> 
<xs:element name="cognome" 

type="xs:string"/> 
<xs:element name="email" type="xs:string"/> 
</xs:sequence> 
</xs:complexType> 
</xs:element> 
</xs:schema>' 



Creiamo quindi in sequenza il message type ed 
il contract. 

CREATE MESSAGE TYPE 

[tipoUtente] 
VALIDATION = 

VALID_XML WITH SCHEMA COLLECTION 

[SchemaUtente] 
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CREATE CONTRACT 



DECLARE @dh uniqueidentifier 



[InseriscilltenteContract] 



BEGIN DIALOG @dh 



( [tipoutente] SENT BY ANY) 

La seguente è la procedura che viene attivata 
quando ci sono messaggi in coda. 

CREATE PROCEDURE dbo.doInserisciUtente 

AS 

BEGIN TRAN 

DECLARE @id uniqueidentifier 

DECLARE @utente XML 

--Leggo il messaggio 

WAITFOR 

( 
RECEIVETOP(l) @id = conversation_handle, 

@utente = message_body 
FROM ReceiverQueue 

) 

--processo il messaggio 
EXECUTE Processalnformazioni @utente 
--chiudo la conversation 

END CONVERSATION @id WITH CLEANUP 

COMMITTRAN 



La Stored Procedure dbo.doInserisciUtente, leg- 
ge il messaggio XML ed esegue Processalnfor- 
mazioni (che inserisce l'utente nella tabella). 
Creiamo quindi la coda per i messaggi, indi- 
cando il nome della procedura da attivare alla ri- 
cezione. 



CREATE QUEUE ReceiverQueue 


WITH STATUS 


= ON, 


ACTIVATION 


( 


PROCEDURE, 


.NAME = doInserisciUtente, 


MAX_QUEUE_ 


_READERS = 5, 


EXECUTE AS SELF 


) 



FROM SERVICE [InserisciUtenteService] 
TO SERVICE 'InserisciUtenteService' 
ON CONTRACT [InserisciUtenteContract]; 



—invia il messaggio 

SEND ON CONVERSATION @dh 

MESSAGETYPE [tipoutente] (©utente) 

Per leggerlo dalla coda ed attivare la stored pro- 
cedure che effettua l'inserimento: 

RECEIVETOP(l) 
CAST(message_body as XML) 
FROM ReceiverQueue 

Il messaggio XML sarà processato dalla stored 
procedure che ne leggerà il contenuto ed inse- 
rirà i dati dell'utente in tabella. 
Per semplicità di esposizione abbiamo lavora- 
to su un unico database, ma è possibile utilizzare 
n database per l'invio dei messaggi ed un altro 
per la ricezione. 



CONCLUSIONI 

Grazie a Service Broker è possibile implemen- 
tare delle architetture Service Oriented, in cui le 
applicazioni inviano messaggi a SQL Server e 
continuano ad eseguire i compiti che stavano 
svolgendo. Questo consente di progettare so- 
luzioni robuste e scalabili con uno sforzo tra- 
scurabile da parte del programmatore che non 
deve più preoccuparsi della gestione di com- 
plesse strutture dati per l'accodamento delle ri- 
chieste o la verifica del recapito dei messaggi. 

Carmelo Scuderì 
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Ed il service 



ABILITARE E DISABILITARE SERVICE BROKER 



CREATE SERVICE [InserisciUtenteService] 
ON QUEUE ReceiverQueue([InserisciUtenteContract]) 

La fase di setup è completa. 
Non ci resta che testare l'invio e la ricezione dei 
messaggi! 

Creiamo il messaggio XML e lo inviamo alla co- 
da 



declare @utente XML 



set @utente 



'<Utente> 



<nome>Carmelo</nome> 



<cognome>Scuderi</cognome> 



<email>webmaster@morpheusweb.it</email> 



</Utente>' 



Service Broker è attivato di 

default quando viene creato un 

database. 

È comunque possibile abilitarlo o 

disabilitarlo tramite delle 

semplici query T-SQL. 

Per disabilitarlo 



ALTER DATABASE nome_database 



SET DISABLE_BROKER 

Per abilitarlo 

ALTER DATABASE nome_database 



SET ENABLE_BROKER 

È poi possibile visualizzare lo 
stato di attivazione di Service 
Broker tramite una view di 
sistema sys.databases: 

SELECT 



service_broker_guid, 



is_broker_enabled 



FROM 



sys.databases 



WHERE 



[name] = 'nome_database'; 
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Swing rende la grafica semplice 



MENU GRAFICI 
E A SCOMPARSA! 

JAVA SI EVOLVE, ED È ORA POSSIBILE CREARE APPLICAZIONI CHE FANNO USO DI MENU 
COMPLESSI, FORMATI DA UNA MISCELA DI GRAFICA, TESTO ED ELEMENTI 
MULTIMEDIALI. INOLTRE SI POSSONO REALIZZARE ALCUNI SIMPATICI EFFETTI... 





REQUISITI 



, — Basi di Java, AWT, 
LJ Swing 



Java Development Kit, 
Editor di testo 




^Cut 

q] c °w 
Paste 



Ctrl-X 
CtrI+Alt-C 
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J Search ctri-s 
SelectAII ctri-A 
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D Pixel 
10 Luci 
E Ombt 
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^fti Carattere... 
Paragrafo... 
!T] Elenchi puntati... 
Bordi e sfondo... 



[J Colonne... 
Tabulazioni... 
Capolettera... 
\^ Orientamento testo... 
Maiuscole /minuscole... 



^ Orienta 
Tema..)' 



(J) Sfondo 

Tema... 
~\ Frame 

Formattazione automatica... 

Stili e formattazione... 
f^~l Informazioni sul formato... 

■ 



Stili e formattazione... 
[TI Informazioni sul formato... 




Fig. 1: Un esempio dei menu grafici che intendiamo 
ottenere utilizzando swing 



Creare, aprire o chiudere un documento 
sono tutte operazioni che effettuiamo 
comunemente. I menu ci aiutano a sceglie- 
re i giusti comandi. Essi offrono una breve descri- 
zione di tutto ciò che si può fare all'interno di un 
sistema. Arricchire ed ampliare un menu significa 
quasi sempre aumentare l'usabilità del software. 
Nel corso dell'articolo vedremo come Java è in 
grado di costruire e personalizzare un menu. 



MUOVIAMO 
I PRIMI PASSI 

La libreria grafica AWT, presente fin dalle 
prime versioni di Java, contiene alcune classi 
per l'implementazione dei menu. Tali classi 
furono progettate in modo da funzionare in 
maniera autonoma. In parole povere "dise- 
gnavano" loro stesse. Con l'introduzione delle 
librerie Swing, il framework è stato reso più 
modulare e scalare. Ogni oggetto grafico 
estende la classe Component, responsabile 



della gestione degli eventi e delle operazioni 
di rendering a basso livello. Vediamo in detta- 
glio come creare una barra dei menu e quali 
sono le differenze sostanziali per chi utilizza 
ancora le vecchie classi. 



APPROCCIO AWT 

Il metodo setMenuBar(MenuBar mb), appar- 
tenente alla classe Frame, visualizza una 
barra dei menu nella parte alta della finestra 
di applicazione. Ogni singolo menu fa riferi- 
mento ad oggetti dell'omonima classe Menu, 
costruiti con un'etichetta di testo. Creiamo 
una barra dei menu con due voci e aggiungia- 
mola al Frame corrente: 

Menu menuFile = new Menu("File"); 

Menu menuModifica = new Menu ("Modifica"); 

MenuBar mb = new MenuBar(); 

mb.add(menuFile); 

mb.add(menuModifica); 

setMenuBar(mb); 

Costruire un menu significa costruire una 
struttura gerarchica, in particolare un albero, 
con nodi intermedi e nodi foglia. Infatti un 
menu può contenere al suo interno due tipo- 
logie di oggetti: una singola voce (nodo foglia) 
o un sottomenu (nodo intermedio). Ogni sot- 
tomenu è a sua volta un oggetto della classe 
Menu, contenente nodi foglia ed eventuali 
nodi intermedi. Le singole voci non sono 
altro che oggetti della classe Menultem. 
Vediamo un esempio: 

Menultem menuFileNuovol = new 

MenuItem("Documento"); 
Menultem menuFileNuovo2 = new 

MenuItemC'Archivio"); 
Menu menuFileNuovo = new Menu("Nuovo"); 
menuFileNuovo.add(menuFileNuovol); 
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menuFileNuovo.add(menuFileNuovo2); 
Menultem menuFileEsci = new MenuItem("Esci"); 
menuFile.add(menuFileNuovo); 
menuFile.add(menuFileEsci); 

Abbiamo utilizzato il solo metodo add 
(Menultem mi) per inserire all'interno del 
menu File sia un sottomenu sia una singola 
voce. Un'occhiata alle API Java ci farà notare 
che la classe Menu estende la classe 
Menultem. 

L'utilizzo delle classi AWT non ci consente di 
andare oltre i semplici menu di testo. 
L'inserimento di bottoni ed immagini è possi- 
bile solo grazie alle estensioni Swing. 



APPROCCIO SWING 

Quanto detto si può riadattare per le classi 
Swing. Teniamo presente però che le classi 
JMenuBar, JMenu e JMenuItem non funzionano 
in maniera autonoma dal punto di vista grafico, 
ma estendono tutte JComponent. In particolare, 
JMenu e JMenuItem sono un'estensione di 
AbstractButton. Creiamo alcuni elementi ed inse- 
riamoli all'interno di un menu: 

JMenuItem menuFileCreateJTextArea = new 

JMenuItem("JTestArea"); 
JMenuItem menuFileCreateJLabel = new 

JMenuItem("JLabel"); 
JMenuItem menuFileCreateJComboBox= new 

JMenuItem("JComboBox"); 
JMenu menuFileCreate = new JMenu("Create"); 
menuFileCreate.add(menuFileCreateJ Label); 
menuFileCreate. add(menuFileCreateJTextArea); 
menuFileCreate. add(menuFileCreateJComboBox); 

Aggiungiamo il menu appena costruito all'in- 
terno del menu principale "File", inserendo 
eventuali elementi sparsi. 

JMenuItem menuFileOpen = new 

JMenuItem("Open"); 
JMenuItem menuFileSave = new JMenuItem("Save"); 
JMenuItem menuFileSaveAs = new 

JMenuItem("Save as..."); 
JMenuItem menuQuit = new JMenuItem("Quit"); 
JMenu menuFile = new JMenu("File"); 
menuFile.add(menuFileCreate); 
menuFile. addSeparator(); 
menuFile. add(menuFileOpen); 
menuFile. add(menuFileSave); 
menuFile. add(menuFileSaveAs); 
menuFile. addSeparator(); 
menuFile. add(menuQuit); 



Visualizziamo il tutto creando una nuova 
JMenuBar e associandola dlJFrame corrente: 

JMenuBar menuBar = new 

JMenuBarQ; 
menuBar.add(menuFile); 
setJMenuBar(menuBar); 

Nell'esempio i vari elementi sono raggruppati attra- 
verso delle linee separatrici, generate dal metodo 
addSeparatorQ. In figura è mostrato il risultato. 
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Fig. 2: In sottomenu ed alcuni elementi aggiuntivi. La 
grafica produce un impatto visivo carente. 



Compilando ed eseguendo il codice prece- 
dente ci accorgiamo che un click del mouse 
sopra una voce di menu non produce alcun 
effetto. Dobbiamo quindi, proprio come nel 
caso di un JButton, aggiungere un oggetto 
ascoltatore presso JMenuItem, in modo da 
catturarne gli eventi associati. Il modo miglio- 
re per farlo è quello di implementare un 
Action listner. Il codice seguente è un esem- 
pio di come possiamo fare 

menuFileQuit.addActionl_istener(new Action Li sten e r() 

{_ 

public void actionPerformed(ActionEvent e){ 

System. exit(O); 

»); 



MENU DI POPUP 




È un oggetto largamente 
utilizzato in tutti i software. In 
genere si tratta del menu che 
compare quando facciamo un 
click destro con il mouse. È 
facile da creare perché segue le 
stesse regole valide per i menu. 



ed in più può essere associato a 
qualunque componente 
all'interno dell'applicazione. È 
un utile strumento per eseguire 
comandi, in determinati 
contesti, in maniera semplice e 
veloce. 
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IMMAGINI 

E SCORCIATOIE 

In genere nelle comuni applicazioni vediamo 
piccole icone accanto ad alcune voci di 
menu. Le immagini non hanno solo una fun- 
zione decorativa ma consentono all'utente di 
riconoscere "a colpo d'occhio" il comporta- 
mento del comando associato. Anche con 
Java è possibile fare ciò. Un oggetto di classe 
JMenuItem può essere costruito a partire da 
una stringa di testo e da un'immagine: 

JMenuItem menuEditCopy = new JMenuItem("Copy", 
new ImageIcon("copy.png")); 

Altra pratica comune è quella di aggiungere 
ad ogni voce di menu una scorciatoia da 
tastiera. Ecco come: 

menuEditCopy.setAccelerator(KeyStroke.getKeyStro 
e(KeyEvent.VK_C, InputEvent.CTRL_MASK)); 

Il secondo parametro del metodo 
getKeyStroke{) è una maschera di bit compo- 
sta dalla somma logica delle varie costanti 
contenute nella classe InputEvent. Se volessi- 
mo associare, ad esempio, alla precedente 
voce di menu la combinazione di tasti 
CRTL+ALT+C dovremmo fare così: 

menuEditCopy.setAccelerator(KeyStroke.getKeyStro 
e(KeyEvent.VK_C, InputEvent.CTRL_MASK + 
InputEvent.ALT_MASK)); 

Applicando le precedenti migliorie il menu 
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Fig. 3: In figura si può apprezzare l'estetica del menu 
una volta inserite le immagini. Le scorciatoie da 
tastiera, di diverso colore e dimensione, sono posizio- 
nate alla sinistra del testo. 



acquisterà più eleganza e sarà un pizzico più 
funzionale. Spingiamoci oltre e miglioriamo il 
raggruppamento degli elementi. 



GRUPPI ESPLICATIVI 

Il raggruppamento delle voci di menu tramite 
l'inserimento di semplici linee separatrici ha 
un impatto puramente visuale. Esso non dice 
nulla riguardo le categorie di azioni in esso 
contenute. Associare un'etichetta di testo per 
ogni gruppo di un menu sta diventando una 
pratica sempre più utilizzata. L'utente ricono- 
sce così con più accortezza i comandi. In Java 
possiamo realizzare tale caratteristica 
aggiungendo un separatore personalizzato 
direttamente alla classe JMenu. Creiamo la 
classe JMenuSeparator, estensione di JPanel, 
con il seguente costruttore: 

public JMenuSeparator(String title) { 

setl_ayout(new Borderl_ayout()); 

JLabel label = new J La bel (title); 

JSeparator separator = new 

JSeparator(); 
label. setForeground(new 

Color(90 # 121,160)); 

label. setFont(new 
Font(label.getFont().getName(),Font.BOLD,ll)); 
separator.setForeground(new 

Color(90 # 121,160)); 

add(label, "Center"); 
add(separator, "South"); 
setBorder(BorderFactory.createEmptyBorder( 15,5,5, 

)); 



Istanziamo un nuovo oggetto JMenu Separa- 
tor per ogni gruppo e posizioniamolo in cima 
agli oggetti che rappresenta. Le classi JCheck 
BoxMenuItem e JRadioButton Menultem 
sono un modo veloce per inserire caselle di 
spunta all'interno dei menu. 

JRadioButtonMenuItem 

menuPluginsArtistico = new 
JRadioButtonMenuItem("Artistico", true); 
JRadioButtonMenuItem 

menuPluginsFotografico = new 
JRadioButtonMenuItem("Fotografico"); 
ButtonGroup group = new 

ButtonGroup(); 
group. add(menuPluginsArtistico); 
group. add(menuPluginsFotografico); 

JCheckBoxMenuItem 

menuPluginsColori = new 
JCheckBoxMenuItem("Colori", true); 
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JCheckBoxMenuItem 

menuPluginsPixel = new 
JCheckBoxMenuItem("Pixel"); 



l'information hiding: 



JCheckBoxMenuItem menuPluginsLuci = new 

JCheckBoxMenuItem("l_uci",true); 
JCheckBoxMenuItem menuPluginsOmbre = new 

JCheckBoxMenuItem("Ombre", true); 



JMenu menuPlugins = 
menuPlugins.add(new 
menuPlugins. add(men 



new JMenu("Plugins"); 

JMenuSeparator("Effetti")); 

uPluginsArtistico); 



menuPlugins. add(menuPluginsFotografico); 
menuPlugins. add(new JMenuSeparator("Filtri")); 
menuPlugins. add(menuPluginsColori); 
menuPlugins. add(menuPluginsPixel); 
menuPlugins. add(menuPluginsLuci); 
menuPlugins. add(menuPluginsOmbre); 





et r* 
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Fig. 4: E' decisamente meglio cercare qualcosa all'in- 
terno di un menu raggruppato, specie se si tratta di 
spuntare delle CheckBox. 



public class ExtJMenuItem extends JMenuItem { 


protected boolean extvisible = true; 


public 


ExtJMenuItem(String text, boolean 


visible) { 


super(text); 


this. extvisible = visible; 


} 


public 


ExtJMenuItem(String text, boolean 

visible, Icon icon) { 


super(text, icon); 


this. extvisible = visible; 


} 


public void setExtVisible(boolean visible) { 


this. extvisible = visible; 


} 


public 


boolean isExtVisibleQ { 


return extvisible; 


} 


} 



Per incorporare la nuova funzionalità abbia- 
mo la necessità di estendere la classe JMenu. 
Teniamo traccia in un vettore dei nuovi ele- 
menti aggiunti. Poi aggiorniamo i cambia- 
menti. 

public void add(ExtJMenuItem menultem) { 
items.add(menultem); 
refreshQ; 



} 



Il metodo refreshQ riposiziona gli elementi 
visualizzando solo quelli per cui la variabile 
extvisible è pari a true. Al termine della pro- 
cedura è necessario un refresh grafico: 




MENU FANTASMA 

Sebbene il nome può suonare strano, abbia- 
mo avuto a che fare un po' tutti noi con que- 
sti particolari menu. Basta utilizzare le appli- 
cazioni contenute nelle ultime versioni del 
pacchetto Microsoft Office. In pratica, ad un 
primo clic del mouse vengono visualizzate 
solo quelle voci di menu che, secondo il pro- 
gettista, risultano più importanti per l'utente. 
Un secondo clic del mouse espande invece il 
menu in maniera completa. Vediamo come 
incorporare questo interessante effetto all'in- 
terno di un'applicazione Java. 
Per prima cosa estendiamo la classe 
JMenuItem includendo una variabile boolea- 
na per ricordarci se l'elemento è visibile 
oppure no. Chiamiamo questa nuova classe 
ExtJMenuItem. Includiamo anche metodi per 



public void refresh() { 




updateUI(); 


getPopupMenu().pack(); 


} 



Come ultimo elemento aggiungiamo un bot- 
tone per espandere l'intero menu. Esso avrà 
associato il seguente ascoltatore: 





HCI è acronimo di Human 
Computer Interaction. Si tratta di 
una scienza che studia l'usabilità 
dei sistemi e l'approccio uomo- 
macchina. Secondo alcuni studi, i 
menu non dovrebbero essere né 
troppo lunghi né troppo 



profondi, in quanto causa di 
disorientamento nell'utente. Un 
valore massimo di profondità si 
aggira intorno ai 7 livelli. In 
sostanza i menu non devono 
avere una struttura molto 
complessa. 
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new Action ListenerQ { 



public void 
actionPerformed(ActionEvent e) { 



showAIIQ; 



> 



> 



showAHO contiene una routine simile a quel- 
la di refreshO, visualizzando proprio tutti gli 
elementi del vettore items. In futuro, quando 
il menu verrà riaperto, dovrà presentarsi col 
suo stato iniziale. All'interno del costruttore 
relativo a ExtJMenu, aggiungiamo un ascolta- 
tore che richiami il metodo di aggiornamento 
refreshf): 

addMenul_istener(new 

MenuListener() { 
public void 
menuCanceled(MenuEvent me) {} 
public void 
menuSelected(MenuEvent me) { refresh(); } 
public void 
menuDeselected(MenuEvent me) {} 
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Fig. 6: Una volta che il menu è stato espanso, gli ele- 
menti principali possiedono un diverso colore di sfon- 
do. L'aggiunta delle immagini rende la grafica grade- 
vole ed esplicativa. 
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Fig. 5: Ecco il risultato finale. Cliccando sul bottone 
con la freccia, ultimo elemento del menu, vengono 
visualizzate tutti gli elementi nascosti. 




iENU CIRCOLARI 



I classici menu che tutti 
conosciamo non sono l'unico 
modo per raggruppare i 
comandi. In passato fu concepito 
anche il concetto di menu 
circolare. Gli elementi sono 
distribuiti ad una stessa distanza 
da un punto fisso. Anziché 
scorrere un intero menu, l'occhio 



umano deve scostarsi solo di 
poco per raggiungere un certo 
obiettivo. Ne consegue però un 
limitato spazio utilizzabile. Se i 
vecchi menu sono ancora 
largamente utilizzati, ciò 
significa che non tutte le nuove 
tecnologie sono allo stesso 
tempo innovative. 



J 



CONCLUSIONI 

Abbiamo sfruttato solo alcune tecniche per 
rendere i nostri menu più usabili e gradevoli 
esteticamente. 

Colori, forme e caratteri possono essere com- 
binati in un'infinita varietà di modi e stili. 
Swing in questo senso rappresenta una via 
d'uscita molto efficace per coloro che voglio- 
no creare applicazioni moderne e funzionali. 
Non c'è un reale appesantimeto delle presta- 
zioni, e per contro l'usabili à delle applicazio- 
ni viene enormemente aumentata. 
Nel progettare i vostri software tenete sempre 
conto che l'utilizzatore finale è spesso qual- 
cuno che non ha una grande esperienza di 
informatica, per tale motivo nella progetta- 
zione per quanto possa sembrare frivolo è 
importante concentrarsi su tutte quelle 
estensioni che possono rendenre il software 
più fruibile. Un enorme peso in questo lo 
assumono i menu che rappresentano sicura- 
mente lo strumento più utilizzato dall'u ente 
finale. La funzione delle icone in una voce di 
menu è quella di assolvere ad un impatto visi- 
vo che non è esclusivamente estetico ma che 
anzi aumenta la comprensione di una funzio- 
ne da parte di chi utilizza un programma. In 
conclusione per realizzare applicazioni pro- 
fessionali è importante anche concentrarsi su 
questi strumenti 

Antonio Trapani 
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INTEGRIAMO LE MAPPE 



SUL POCKET PC 

IN QUESTO ARTICOLO SFRUTTEREMO UN WEB SERVICE DI MICROSOFT PER VISUALIZZARE 
SU UNA MAPPA LA POSIZIONE DEGLI INDIRIZZI SALVATI SULLA RUBRICA. CON VISUAL 
STUDIO 2005 MOLTE OPERAZIONI RISULTERANNO SEMPLIFICATE... 




n 




LJ Basi di C# 



Windows XP/2003, .net 
Framework 2.0, 
Microsoft Visual Studio 
.NET 2005, Windows 
Mobile 5.0 SDK, SQL 
Server 2005 Mobile 
Edition 
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Tempo di realizzazione 



Nel precedente articolo, abbiamo visto 
come realizzare un'applicazione com- 
pleta che permette, agli agenti di una 
società, di creare ordini su un dispositivo mobi- 
le. Per farlo, abbiamo usato Microsoft .NET 
Compact Framework 2.0 e un dispositivo 
Windows Mobile 5.0. Nell'articolo abbiamo vi- 
sto come questi due prodotti, rendano molto 
semplice lo sviluppo di applicazioni anche 
complesse, grazie tanto alle novità introdotte 
dal Compact Framework quanto dalle nuove 
API esposte dal nuovo sistema operativo. 









Fig. 1: L'applicazione che realizzeremo 

In questo articolo, ci concentreremo sull'ag- 
giunta di una funzionalità particolare al no- 
stro software. Sebbene non sia di vitale im- 
portanza, è decisamente comodo per una 
agente visualizzare la mappa del luogo in cui 
si trova il cliente. Vedremo quindi come farlo 
prendendo direttamente i dati dall'anagrafica 
ed usando il servizio web messo a disposizio- 
ne da MapPoint. 
Iniziamo! 



MAPPOINT 

MapPoint è il sistema sviluppato da Microsoft 
per la localizzazione geografica. Questo pro- 
dotto è distribuito sostanzialmente in 3 ver- 



sioni diverse adatte a scopi specifici. Vedia- 
mole brevemente: 

• MapPoint Web Service: è un servizio web 
che espone sostanzialmente il motore di 
MapPoint. Attraverso l'utilizzo di questo 
servizio è possibile realizzare applicazioni 
personalizzate per la gestione della loca- 
lizzazione geografica senza preoccuparsi 
di istallare altri prodotti sui PC dei nostri 
clienti. 

• MapPoint Location Server: è un sistema 
di localizzazione real time che sfrutta di- 
spositivi mobili e MapPoint Web Service 
per la localizzazione immediata di entità 
in movimento. 

• MapPoint 2004: è la versione software di 
MapPoint. Questa versione è stata realizzata 
sia per poter essere utilizzata direttamente, 
sia per poter visualizzare informazioni pro- 
venienti da file del pacchetto office. 

Escludendo la versione MapPoint Location 
Server (la cui implementazione esula dallo 
scopo di questo articolo), per una applicazio- 
ne standard abbiamo la possibilità di sceglie- 
re tra la versione MapPoint Web Service e la 
versione MapPoint 2004. Tale scelta deve es- 
sere fatta in modo ponderato onde evitare di 
sprecare i nostri soldi (o quelli dei nostri 
clienti). I costi delle 2 versioni sono abbastan- 
za diversi tra loro, sebbene quello della versio- 
ne client {MapPoint 2004) è definito ($ 299) e 
quello della versione WebService sia abba- 
stanza complesso da calcolare e bisogna con- 
tattare Microsoft per avere una stima precisa 
dei costi. 
Il mio personale consiglio è: 

• MapPoint 2004: per singole applicazioni, 
non multiutenza e che devono lavorare in 
modalità disconnessa. 

• MapPoint Web Service: per applicazioni 
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client- server, applicazioni web, installa- 
zioni multiple, applicazioni connesse. 

Per applicazioni per dispositivi mobili invece, 
il problema della scelta non si pone: dobbia- 
mo usare il servizio web. 



IL SERVIZIO WEB 
DI MAPPOINT 

Il servizio web di MapPoint permette agli svi- 
luppatori di creare applicazioni basate sul 
motore di generazione della mappe, sfruttan- 
do appunto un servizio web. 
I vantaggi derivanti dall'utilizzo di questo si- 
stema sono molteplici. Innanzitutto non c'è la 
necessità di installare componenti sui PC. Il 
servizio web infatti, permette di eseguire qua- 
si tutte le operazioni possibili con la versione 
client senza la necessità che essa sia installa- 
ta. Altro vantaggio è sicuramente la semplicità 
di utilizzo, soprattutto in applicazione basate 
sul Microsoft .NET Framework. Vedremo 
infatti che, con poche righe di codice, sarà 
possibile generare mappe, semplicemente 
passando al servizio web un indirizzo. 
Uno degli svantaggi intrinseci di questa tec- 
nologia è però la necessità di un collegamen- 
to ad internet. In servizio web infatti, come 
dice il termine stesso, scambia informazioni 
con la nostra applicazione attraverso il web. 
Motivo per cui, il vincolo di utilizzo di questa 
tecnologia è avere una connesione attiva. 
Prima di iniziare ad utilizzare il servizio web, è 
necessario compiere alcune operazioni preli- 
minari. 

Innanzi tutto il servizio non è pubblico ma 
privato ed a pagamento. Fortunatamente, Mi- 
crosoft mette a disposizione di noi sviluppa- 
tori degli account di test gratuiti. Sostanzial- 
mente ci sono due differenze tra l'account di 
staging e quello reale: l'account di staging 
consente un massimo di mille interrogazioni 
al giorno (più che sifficienti in fase di svilup- 
po) a differenza di quello a pagamento in cui 
non c'è questo limite. La seconda differenza è 
che il servizio a pagamento è tendenzialmen- 
te più veloce di quello di staging. 
Questi due limiti però, non complicano in 
alcun modo lo sviluppo ed il test delle nostre 
applicazioni. 

Richiedere l'account di staging è abbastanza 
semplice: basta accedere al seguente indirizzo 
web: https://mappoint-css. partner s.extranet. 
microsoft.com/MwsSignup/Eval2.aspXy compi- 
lare il form con la richiesta ed attendere un 
paio di giorni che venga attivato. 



Una volta ricevute le password per accedere al 
servizio, siamo pronti ad iniziare lo sviluppo. 



PREDISPOSIZIONE 
DELL'AMBIENTE 

Ricevute le credenziali di accesso al servizio 
web, dobbiamo predisporre l'ambiente di svi- 
luppo e soprattutto l'emulatore per il corretto 
funzionamento. 

Il primo passo è quello di installare, se non lo 
abbiamo già fatto, il Windows Mobile 5.0 SDK 
(vedi box laterale) e configurare il nostro 
emulatore ad usare la connessione ad internet 
del PC su cui stiamo lavorando. 
Per farlo, avviamo l'emulatore da Microsoft 
Visual Studio .NET 2005, selezioniamo il 
menu File e la voce Configura. Dovrebbe 
apparire una maschera simile a quella di 
Figura 2. 
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Fig. 2: La configurazione dell'emulatore 

Scegliamo quindi la scheda Network e spun- 
tiamo la voce "Enable NE2000 PCMCIA Net- 
work Adapter and bind to:" scegliendo, ove 
possibile, una scheda di rete del nostro PC. 
L'operazione appena eseguita permetterà al- 
l'emulatore di collegarsi alla nostra rete e di 
navigare sul web. 

Per verificare che tutto sia configurato a dove- 
re, apriamo il Pocket Internet Explorer e pro- 
viamo a navigare su un sito. 
Completata questa operazione, non ci resta 
che scrivere il nostro codice. 



LA MOSTRA 
APPLICAZIONE 

Come applicazione d'esempio, usiamo la 
stessa vista nell'articolo precedente, a cui ov- 





SUL WEB 



Tutti i dettagli relativi a 
MapPoint possono 
essere recuperati dal 
sito ufficiale al 
seguente indirizzo: 
http://www.microsoft.com/ 
mappoint/default.mspx . 
Seguendo i link relativi 
al servizio web sarà poi 
possibile attivare un 
account di tipo 
Developer per eseguire 
i propri test. 
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DOVE TROVO 

IL WINDOWS 

MOBILE 5.0 

SDK? 

Il Microsoft Windows 
Mobile 5.0 SDK è scari- 
cabile al seguente indi- 
rizzo web: 

http://www.microsoft.com 
/downloads/details.aspx 
?familyid=83A52AF2 
-F524-4EC5-91 55-71 7CBE5 
D25ED&displaylang=en 
ed include gli emulatori 
ed i template di Micro- 
soft Visual Studio .NET 
2005. 



viamente aggiungeremo gli elementi utili a 
generare e visualizzare le mappe. 
Avendo a che fare con un dispositivo mobile, 
sappiamo già di avere a disposizione poco 
spazio sul display. Ne consegue che la mappa 
dovrà essere visualizzata in un nuvo form. Ag- 
giungiamone quindi uno al progetto che chia- 
meremo MapRender.es. Al suo interno inseri- 
remo una picture box (pictureBoxMappa), il 
cui scopo sarà quello di visualizzare la nostra 
mappa ed una label (labellndirizzoCliente) 
che mostrerà l'indirizzo del cliente seleziona- 
to. Il nuovo form dovrebbe apparire come in 
Figura 3. 



File Edit View Project 
£t | l& * €l | «ir ■* 



Build Debug Data Tools Window Community Help 

k Debug - Any CPU 
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Fig. 3: II form per la visualizzazione delle mappe 

Modifichiamo ora il costruttore del form in 
modo che accetti dei parameri in ingresso. 
Quello che vogliamo infatti è che, una volta 
aperto, il form mostri direttamente la mappa 
relativa all'indirizzo di un cliente. Per farlo, 
l'indirizzo deve essere passato al form: 

namespace MobileApplication { 

public partial class MapRender : Form { 
public MapRender(string Cliente, string 

indirizzo, string cap, string citta) { 
InitializeComponent(); 

if ( Cursor.Current == Cursors.WaitCursor){ 
Cursor.Current = Cursors. Default; 

} 

this.Name = "Cliente: " + Cliente; 
labellndirizzoCliente. Text = indirizzo + " " 

+ cap + ", " + citta; 



testo della label labellndirizzoCliente con i 
dati presi dal costruttore. 
Pronto il form, non dobbiamo aprirlo, e lo fac- 
ciamo aggiungendo un nuovo bottone (btn- 
FindMap) nel form in cui sono presenti le 
anagrafiche dei clienti (Clienti.cs) come in Fi- 
gura 4. 






Telefono 




Mappa 



Crea 






Dopo l'inizializzazione dei componenti (Ini- 
tializaComponentQ), impostiamo anche il 



Fig. 4: L'aggiunta del bottonre Mappa al form dei 
clienti 



Il codice da associare all'evento click di que- 
sto bottone servirà quindi ad aprire il form 
MapRender.es passandogli i parametri corret- 
ti: 

private void btnFindMap_Click(object sender, 

EventArgs e) { 
Cursor.Current = Cursors.WaitCursor; 
string Cliente = string. Empty; 
int indiceRiga; 
indiceRiga = 

dataGridClienti.CurrentCell.RowNumber; 
Cliente = appDatabaseDataSet.tblClienti.Rows[ 

indiceRiga] [l].ToString(); 
MapRender mapRender = new MapRender(Cliente, 
IblIndirizzo.Text, IbICAP.Text, IbICittà.Text); 
mapRender.ShowDialogO; 
} 



Oltre ai dati relativi all'indirizzo, ci conviene 
passare il nominativo del cliente. Trovandosi 
in un form separato infatti, il nostro utilizza- 
tore potrebbe non essere sicuro di aver clicca- 
to sul cliente corretto quindi è il caso di visua- 
lizzarlo. Sebbene il nominativo del cliente si 
trova all'interno della DataGridView e potreb- 
be essere recuperato da lì, converrebbe recu- 
perarlo dal DataSource. Le colonne della gri- 
glia possono infatti essere modificate, nasco- 
ste o spostarte e si correrebbe il rischio di 
recuperare un dato errato. 
Ora che abbiamo il form pronto ed i parame- 
tri con cui generare la mappa, siamo pronti ad 
usare il servizio web di MapPoint. 
Dopo aver creato il riferimento web, aggiun- 
giamo al nostro progetto una nuova classe de- 
nominata MapGenerator.es che avrà il compi- 
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to di generare la mappa e restituirla sotto for- 
ma di immagine. 

Una delle prime cose da fare nella nostra clas- 
se è quella di aggiungere la direttiva "using 
Mobile Application, net. mappoint.staging;" in 
modo da poter usare i metodi del servizio web 
in modo più comodo. 

Come detto in precedenza, al fine di poter ge- 
nerare una mappa, abbiamo bisogno di alcu- 
ni elementi. Un punto su una mappa può in- 
fatti essere localizzato in due modi: o attraver- 
so una coppia di coordinate geografiche (lati- 
tudine e longitudine) di cui però non dispo- 
niamo, o attraverso un indirizzo (che abbia- 
mo). Questo però, deve essere prima "trovato" 
da MapPoint, e solo successivamente potrà 
essere usato per disegnare la mappa. 
Dopo aver passato al servizio web le nostre 
credenziali con il codice: 

findService.Credentials = new 

System. Net. NetworkCredential(UserName, 

Password); 
findService.PreAuthenticate = true; 
renderService.Credentials = new 

System . Net. NetworkCredential( 
UserName, Password); 
renderService.PreAuthenticate = true; 

sia al servizio di ricerca (findService) che a 
quello di generazione della mappa (render- 



Service), eseguiamo una ricerca all'interno del 
Data Base di MapPoint con il seguente codice: 

//Creiamo un oggetto Address usando l'indirizzo del 

cliente 
Address myAddress = new Address(); 
myAddress.AddressLine = Indirizzo; 
myAddress. PrimaryCity = Citta; 



myAddress. PostalCode = CAP; 



myAddress. CountryRegion = "IT"; 



//Specifichiamo in quale Data Source l'indirizzo deve 

essere ricercato 
findAddressSpec.DataSourceName = "MapPoint. EU"; 
findAddressSpec.InputAddress = myAddress; 



//Eseguiamo la ricerca dell'indirizzo 
foundAddressResuIts 



findService. FindAddress( 

findAddressSpec); 



Dopo aver localizzato l'indirizzo, dobbiamo 
specificare a MapPoint "cosa" vogliamo vede- 
re. MapPoint infatti, contiene le mappe di 
quasi tutto il pianeta e a noi serve solo una 
piccola porzione di esso. Per farlo, usiamo 
l'oggetto ViewByScale che ci permette di defi- 
nire una scala per la nostra mappa: 

views = new ViewByScale[l]; 
views[0] = new ViewByScale(); 
views[0].CenterPoint = new LatLongQ; 





SUL WEB 



Uno dei siti di riferi- 
mento per chi deve im- 
plementare soluzioni 
basate su MapPoint è 
sicuramente 
http://www.mp2kmag.com . 
In esso si trovano nu- 
merosi articoli, tips, 
spezzoni di codice che 
spiegano in modo pre- 
ciso i passi da seguire 
per implementare solu- 
zioni basate su questo 
prodotto. 



UTILIZZIAMO IL WEB SERVICE 

Per utilizzare il servizio web di MapPoint dopo aver ricevuto da Microsoft le credenziali di accesso, dobbiamo 
aggiungere un riferimento web al nostro progetto. Le istruzioni sono riportare nel riquadro in basso. 



> IL MENU ADD REFERENCE > IL WEB SERVICE 




I Facciamo click con il tasto destro del 
I mouse sulla cartella "Web Reference " 
del nostro progetto nel solution explorer. 
Selezioniamo la voce "Add web reference" 
Questa operazione ci consentirà di accede- 
re ad una seconda dialog box in cui potremo 
indicare la posizione del Web Service 



i*J 
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J Nella maschera che verrà aperta, imin- 
seriamo l'indirizzo del servizio web 
(http://staging.mappoint.net/standard-30/map- 
point.wsdl) e clicchiamo sulla freccia verde. 
Verranno visualizzati tutti i metodi che il ser- 
vizio espone ed il nome da assegnare al ri- 
ferimento web (net.mappoint.staging) 



> METODI E PROPRIETÀ 



^ net.mappoint.staging 

Émappoint.vvsdl 
Reference. map 

itti 



+ 



Da questo istante sarà possibile usa- 
Ire tutti i metodi esposti dal servizio 
come se fossero relativi ad un oggetto lo- 
cale. L'aggiunta del riferimento ha infatti 
creato una classe denominata proxy che ha 
lo scopo di rendere trasparente, per lo svi- 
luppatore, il web service 
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views[0].CenterPoint.l_atitude 



foundAddressResults.Results[0] 
.FoundLocation.LatLong.Latitude; 




Michele Locuratolo è 
Software Archi tect per 
la Mindbox S.r.l. di 
Capurso (BA), società 
che si occupa di 
consulenza e sviluppo 
software. È cofondato- 
re di DotNetSide.org, 
lo user group del Sud 
Italia il cui intento è 
quello di organizzare 
eventi di maggior 
spessore tecnico legati 
allo sviluppo con il 
.NET Framework. Il suo 
blog è raggiungibile 
all'indrizzo 
http://www.dotnetside 
■org/blogs/mighell 



views[0].CenterPoint.l_ongitude = 

foundAddressResults. Results[0 
].FoundLocation.l_atl_ong.Longitude; 
views[0].MapScale = 250000; 

All'istanza di ViewByScale specifichiamo una 
serie di parametri come il centro della mappa 
e la scala. 

Siamo quasi pronti a mostrare il risultato. Ci 
mancano però ancora due elementi. 
Il primo è la famosa bandierina che, sulla 
mappa, indica il punto preciso da noi ricerca- 
to. In MapPoint si chiama PushPin che defi- 
niamo come segue: 

Pushpin[] pushpins = new Pushpin[l]; 
pushpins[0] = new Pushpin(); 
pusnpins[0].IconDataSource = "MapPoint. Icons"; 
pushpins[0].IconName = "0"; 
pushpins[0].l_atl_ong = views[0].CenterPoint; 
pushpins[0].ReturnsHotArea = true; 
pushpins[0]. Label = cliente; 

Per la definizione della nostra bandierina, 
specifichiamo un insieme di icone (un elenco 
completo è disponibile al seguente indirizzo: 
h ttp://msdn. microsoft, comllibraryl default, asp 
?url-/library/en-us/mappointsdk/html/Tables- 
Icons.asp) , il punto preciso in cui deve essere 
disegnata ed una label, che nel nostro caso 
sarà il nome del cliente. 

Il secondo elemento di cui abbiamo bisogno è 
una serie di specifiche per il disegno della 
mappa. Se fino ad ora abbiamo trovato il pun- 
to, specificato quale parte del pianeta voglia- 
mo vedere e dove puntare la "bandierina", ora 
dobbiamo mettere insieme tutti questi ele- 
menti nell'oggetto MapSpecification: 

MapSpecification mapSpec = new MapSpecification(); 
mapSpec.DataSourceName = "MapPoint. EU"; 
mapSpec.Views = views; 
mapSpec. Pushpins = pushpins; 
mapSpec.Options = new MapOptions(); 
mapSpec. Options. Format = new ImageFormat(); 
mapSpec.Options. Format. Width = x; 
mapSpec.Options. Format. Height = y; 
mapSpec. Options. Style = MapStyle. Politicai; 



Ora abbiamo tutti gli elementi e possiamo 
chiedere al servizio web di mostrarci la map- 
pa: 

Maplmage[] maplmages = 

renderService.GetMap(mapSpec); 



System. IO. Stream streamlmage = new 
System. IO. MemoryStream( 

mapImages[0].MimeData.Bits); 
Bitmap bitmaplmage = new Bitmap(streamlmage); 
return bitmaplmage; 

Per usarla, non ci resta che completare il codi- 
ce del costruttore del form MapRender.es con 
le seguenti istruzioni: 

namespace MobileApplication { 

public partial class MapRender : Form { 
public MapRender(string Cliente, string 

indirizzo, string cap, string citta) { 
InitializeComponentO; 
if ( Cursor.Current == Cursors.WaitCursor) 

{ 

Cursor.Current = Cursors. Default; 

} 

this.Name = "Cliente: " + Cliente; 
labelIndirizzoCliente.Text = indirizzo + " " 

+ cap + ", " + citta; 
MapGenerator mp = new MapGenerator(); 
this.pictureBoxMappa.Image = 

mp.MakeMap(Cliente, indirizzo, cap, citta, 

pictureBoxMappa. Width, 

pictureBoxMappa. Height); 



Il risultato sarà quello visibile in Figura 1. 



CONCLUSIONI 

I dispositivi mobili hanno cambiato il nostro 
modo di lavorare rendendo il nostro lavoro 
decisamente più comodo. Se provassimo a 
pensare a come avrebbe dovuto lavorare il 
nostro agente solo cinque anni fa (carta, 
penna, tuttocittà, cartina geografica, agendi- 
na etc), ci potremo rendere subito conto delle 
potenzialità fornite dalla tencologia. Per 
quanto riguarda la nostra professione, i nuovi 
strumenti, i nuovi mezzi e le nuove tencologie 
ci aiutando a realizzare software sempre più 
comodi e facili da utilizzare. Questo va certa- 
mente a vantaggio del nostro cliente/utilizza- 
tore, ma va anche a nostro vantaggio, aprendo 
scenari di business fino a ieri preclusi. 
In questi due articoli abbiamo visto come, in 
poco tempo, è possibile realizzare una appli- 
cazione abbastanza evoluta, comoda da usare 
e ricca di funzionalità come la generazione 
delle mappe. I mezzi, oggi, ci sono. Spazio alla 
fantasia dunque! 

Michele Locuratolo 
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FACCIAMO VIAGGIARE 
I DATI SU INTERNET 

IN QUESTO ARTICOLO CREEREMO UN SERVER PERSONALIZZATO CHE ATTENDE RICHIESTE 
SU UNA PORTA PREDEFINITA. CONTEMPORANEAMENTE SVILUPPEREMO UN CLIENT PER LA 
CONNESSIONE. ET VOILÀ GETTATE LE BASI PER UNA CHAT, IL P2P O ALTRO.... 





MeMMU.MiU.IUit 
rr Per implementare il 
'— ' progetto sono 

necessarie conoscenze 
di base sui protocolli e 
sulla gestione dei file e 
dei controlli. 



Piattaforma Windows 
2000 o superiore - 
Visual Basic 6 SP6. 



L^ L^2L^L=2- 



Tempo di realizzazione 
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E noto che la comunicazione tra compu- 
ter avviene in base alle regole stabilite 
nei protocolli di trasmissione dati. I 
protocolli di trasmissione, in larghe linee, 
possono essere divisi in due tipi: protocolli di 
alto livello, che definiscono le regole per la 
trasmissione di singoli elementi come per 
esempio file o pacchetti, e protocolli di basso 
livello che si preoccupano di stabilire le rego- 
le per la trasmissione dei singoli byte o bit. Di 
ciò si è occupato l'ISO (International 
Standard Organization) già nel lontano 1979, 
quando definì il modello OSI (Open System 
Interconnection Model) come riferimento 
per la progettazione delle reti. Per fortuna, 
Visual Basic permette di gestire la comunica- 
zione tra computer con i controlli Winsock ed 
Inet ed il programmatore non deve preoccu- 
parsi di come i protocolli sono implementati. 
Il controllo Winsock consente di utilizzare i 
protocolli di trasmissione TCP/IP e UDP, 
mentre le applicazioni per il protocollo FTP 
possono essere gestite con il controllo 
Internet Transfer (Inet). Ricordiamo che il 
protocollo TCP (Transmission Control 
Protocol) è indicato per applicazioni 
Client/ Server, cioè per le applicazioni che 
permettono lo scambio di dati tra una mac- 
china denominata Server ed una o più mac- 
chine denominate Client, il protocollo UDP 
(User Datagram Protocol) è soprattutto indi- 



CECLIERE URI NOME PER IL COMPUTER 



In generale per connettersi in 
remoto ad un computer bisogna 
conoscere il suo IP o il suo nome. 
Come è noto l'IP di un computer è 
una stringa numerica composta da 
4 gruppi di 3 cifre separati da un 
punto. Ad esempio un IP può 
essere il seguente:125.1.2.124. Di 
solito l'IP di un computer non 
collegato in rete è 127.0.0.1 che 



rappresenta l'indirizzo dell'host 
locale a cui si può fare riferimento 
anche con il nome di localhost. Per 
conoscere il nome o l'IP di un 
computer collegato in rete si può 
procedere in vari modi, per 
esempio si può usare la scheda 
connessione alla Rete del pannello 
di controllo o il comando Dos 
Ipconfig. 



J 



cato per applicazioni di tipo Peer to Peer 
(paritetiche), mentre il protocollo FTP (File 
Tansfer Protocol) è principalmente indicato 
per il trasferimento di file di grosse dimen- 
sioni, per esempio si usa quando si scaricano 
file da Internet, o quando dal proprio com- 
puter si trasferiscono file sul Server di un 
Internet Provider. In questo articolo presen- 
tiamo un'applicazione Client- Server, basata 
sul controllo Winsock e il protocollo TCP/IP, 
che consente di gestire la trasmissione di file 
tra computer. Prima, però, facciamo un breve 
cenno sui protocolli ed i controlli citati. 



TCP, UDP E FTP 

Il protocollo TCP è nato nel mondo Unix ed 
ormai è disponibile su tutti i tipi di sistemi 
operativi. È un protocollo che garantisce la 
corretta trasmissione dei dati inviati e ricevu- 
ti, conservandone la corretta sequenza di tra- 
smissione e ricezione. Insieme all'IP Protocol 
(Internet Protocol) che si occupa essenzial- 
mente deirinstradamento dei pacchetti di 
dati, costituisce l'elemento fondante di 
Internet. TCP è un protocollo orientato alla 
connessione concepito per la trasmissione 
da punto a punto tra un computer Client e 
uno Server, per questo in un'applicazione 
che utilizza il protocollo TCP la cosa fonda- 
mentale da stabilire è se si tratta di un'appli- 
cazione Client o Server. In parole povere pos- 
siamo dire che il funzionamento del TCP è 
analogo al funzionamento del telefono tradi- 
zionale e cioè prima di dialogare bisogna sta- 
bilire una connessione. UDP è un protocollo 
utilizzato soprattutto per lo scambio di mes- 
saggi. L'UDP a differenza del TCP non richie- 
de una connessione esplicita tra i computer 
cioè è di tipo connectionless. La mancanza di 
una connessione ne fa un protocollo poco 
affidabile ma veloce e semplice da utilizzare. 
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Con il protocollo UDP i computer possono 
avere un comportamento equivalente (pos- 
sono trasmette e ricevere allo stesso modo, 
non è definita la figura del computer client e 
del computer server) per questo le applica- 
zioni che utilizzano l'UDP si possono consi- 
derare di tipo Peer to Peer. Un'altra caratteri- 
stica di questo protocollo è che può essere 
usato per inviare messaggi in broadcast, cioè 
contemporaneamente su più nodi della rete. 
L'FTP (File Tansfer Protocol) è un protocollo 
che nasce nel 1972 nel MIT (Massachussets 
Institute of Technology), le specifiche 
dell'FTP vengono descritte nella RFC 114. 
L'FTP unisce i comandi del TCP/IP e del 
Telnet Protocol (Protocolli sviluppati con 
ARPAnet), si basa sul codice ASCII ed in par- 
ticolare ne usa, solo, la parte inferiore (ASCII 
a 7 bit). I comandi dell'FTP oltre a controlla- 
re il flusso dei file, da e verso il Server, con- 
sentono, quando si trasmettono file, di inte- 
ragire con il processo in atto sul Server. Ai 
Server FTP è possibile accedere anche attra- 
verso un Web Browser, in questo caso l'indi- 
rizzo da specificare è del tipo ftp://ftp.micro- 
soft.com. 



Pagine proprietà 



General I 
Protocol 
RemoteHost 
RemotePort 
LocalPort 




OK 



j Annulla Applica ? 



Fig. 1: La finestra delle proprietà del Winsock 



I CONTROLLI WINSOCK 
E INTERNET TRANSFER 

Come accennato Winsock è il controllo che 
consente di utilizzare i protocolli di trasmis- 
sione UDP e TCP, esso fa parte della libreria 
Microsoft Winsock Control 6.0 (in cui è presente 
l'OCX MSWINSCK); di seguito, brevemente, 
ne descriviamo le proprietà, i metodi e gli 
eventi più importanti. Iniziamo dalla pro- 
prietà che consente di scegliere il tipo di pro- 
tocollo, cioè Protocol che è disponibile in fase 
di progettazione, nella finestra delle pro- 
prietà, e a run-time, i valori che supporta 
sono: sckTCPProtocol e sckUDPProtocol. La pro- 



prietà LocalHostName, invece, restituisce il 
nome della macchina su cui si esegue l'appli- 
cazione. È una proprietà di sola lettura, per 
esempio nel modo seguente si può conosce- 
re il nome del proprio computer: 

Msgbox (Winsockl. LocalHostName) 

La proprietà LocalPort imposta o restituisce il 
numero della porta locale. Per il Client è la 
porta locale dalla quale sono inviati i dati, 
per il Server, invece, è la porta locale di atte- 
sa da dove riceveranno i dati. Le porte UDP e 
TCP disponibili per le applicazioni sono 
65536, la porta che di solito viene utilizzata 
con TCP/IP è la 1023. Questa proprietà è set- 
tabile in fase di esecuzione e di progettazio- 
ne. RemoteHost restituisce o imposta l'identifi- 
cativo dell'host remoto, è una proprietà 
disponibile sia in fase di progettazione che 
d'esecuzione. Questa può essere impostata 
come indirizzo IP o come DNS. RemotePort 
restituisce o imposta la porta dell'host remo- 
to; dopo che è impostata la proprietà 
Protocol la RemotePort è impostata sulla porta 
predefinita e cioè la 80 per il protocollo 
HTTP. La proprietà State restituisce lo stato 
del controllo, è di sola lettura e non è dispo- 
nibile durante la fase di progettazione. 
Ora vediamo i principali eventi: Close si veri- 
fica quando il computer remoto chiude la 
connessione. ConnectionRequest viene 
intercettato sul Server quando il Client 
richiede una connessione. DataArrival è Te- 
vento che avviene, quando arrivano nuovi 
dati al Server o al Client. Error si verifica, 
quando, durante una connessione, c'è un 
errore. Infine c'è l'evento SendProgress (con 
parametri BytesSent e BytesRemaining), 
generato durante l'invio dei dati, che può 
essere usato per avere informazioni sui byte 
inviati (Sent) e da inviare (Remaining) . 
I Metodi che utilizzeremo invece sono i 
seguenti: Accept viene utilizzato nell'evento 
ConnectionRequest per accettare una connes- 
sione, ad esso viene passato un parametro 
nominato RequestlD che può servire per iden- 
tificare il Client. Connect instaura una con- 
nessione con il computer remoto, richiede 
come parametro l'indirizzo della macchina a 
cui ci si vuole connettere e il nome della 
porta utilizzata dal computer per la connes- 
sione. Close termina una connessione TCP sia 
da applicazioni Client sia Server. GetData 
estrae un blocco di dati dal buffer e lo memo- 
rizza in una variabile di tipo Variant. Listen 
pone il Server in ascolto delle richieste dei 
Client. SendData invia i dati ad un computer 
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remoto; facciamo notare che quando si devo- 
no inviare dati binari bisogna utilizzare una 
matrice di Byte. 

Il controllo Internet Transfer (Inet) consente 
di attivare una connessione FTP o HTTP e di 
eseguire dei comandi. I tipi di comandi che 
possono essere eseguiti dipendono dal pro- 
tocollo di trasmissione selezionato cioè 
HTTP oppure FTP. I principali metodi del 
controllo sono: OpenURL ed Execute. 
OpenURL apre un elemento (pagina, direc- 
tory) che si trova alFURL specificato. La sin- 
tassi è la seguente: 

object.OpenUrl URL [,datatype] 

URL è l'indirizzo dove si trova Y elemento che 
deve essere aperto. DataType è un parametro 
opzionale che specifica il tipo di dato da leg- 
gere: dato stringa, 1 dato byte array. 
Execute permette di inviare un comando ad 
un Server. La sintassi è la seguente: 

object. Execute uri, operation, data, 

requestHeaders 

URL indica l'URL da utilizzare, se non speci- 
ficato verrà utilizzato quello di OpenUrl. 
Operation è una stringa che specifica il tipo di 
operazione da eseguire. Data è una stringa 
che specifica le informazioni che verranno 
utilizzate dall'operazione. RequestHeaders è 
una stringa che specifica informazioni sup- 
plementari. Le proprietà principali del con- 
trollo sono: AccessType, Protocol, URL. Per esem- 
pio AccessType è utilizzata per specificare il 
tipo di accesso alla rete Internet, infatti come 
è noto la connessione di un computer client 
ad Internet può avvenire direttamente o tra- 
mite Proxy che eventualmente funge da fil- 
tro, per questo i valori che la proprietà può 
assumere sono: cNamedProxy, icDirect e 
IcUseDefault. Se su un form inserite un con- 
trollo Inet e un RichTextBox con il seguente 
esempio potete aprire un file presente in uno 
spazio ftp. 



COMANDI IPCOMFIG E PING 



Sicuramente i comandi più 
utilizzati dai gestori delle reti 
aziendali sono Ipconfig e Ping. 
Ipconf ig permette di conoscere 
il nome e l'IP di un computer 
connesso in rete. Ping, invece, 
permette di capire se un 
computer è raggiungibile da una 
certa postazione e con quale 



velocità si comunica con esso. La 
sintassi è la seguente Ping Nome 
dove Nome può essere l'IP o il 
nome di un computer. Per 
utilizzare questi comandi basta 
aprire una sessione Prompt dei 
Comandi (MsDos) e al Prompt 
scrivere il comando e dare 
l'invio. 



RichTextBoxl.Text = Inetl. OpenURL . 

(InputBoxC'URL", , 

"FTP://ftp. sitoftp.it/miofile. zip")) 



Per eseguire il codice precedente dovete 
sostituire sitoftp con il sito dal quale volete 
scaricare il file. Naturalmente, per eseguire 
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Fig. 3: Le form dei progetti Client e Server 

T operazione, dovete avere gli opportuni per- 
messi di accesso. 



APPLICAZIONE 
CLIENT-SERVER 

L'applicazione basata sul Winsock è compo- 
sta da due progetti: uno Client ed uno Server. 
In particolare l'applicazione Client permette 
di ricercare dei file in locale ed inviarli al 
Server. A tal fine il Client deve conoscere TIP 
del Server e la porta che il Server utilizza per 
ricevere le richieste. Oltre a ciò, per semplifi- 
care, ipotizziamo che il Client conosca la 
directory del Server dove vengono trasferiti i 
file. Per sincronizzare i messaggi, tra il Server 
ed il Client, abbiamo definito il semplice pro- 
tocollo schematizzato nella Tabella 1. Notate 
che i messaggi di sincronizzazione sono di 7 
caratteri e terminano con due punti. Per 
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Messaggi dal Client al Server 


MSG-CLN: 


Invio il Nome del Client 


MSG-DES: 


Invio il Nome del File 


MSG-EOF: 


Ho finito d'inviare il File 


Messaggi dal Server al Client 


MSG-OKC: 


Ok sei Connesso 


MSG-OKI: 


Ok puoi iniziare ad inviare 
i blocchi di byte 


MSG-RIC: 


Blocco Byte Ricevuto 


MSG-CLC: 


Ti ho sconnesso 




i Tabella 1 1l nostro Protocollo di trasmissione 




esempio quando il Client deve inviare il suo 
nome invierà MSG-CLN:nomeclient, mentre 
se deve comunicare che ha finito d'inviare i 
blocchi di dati invierà MSG-EOF: 
Presentiamo tutto il codice del progetto 
Server e soltanto la parte principale del codi- 
ce del progetto Client 

1 Create due progetti EXE e nominateli 
rispettivamente ioClient e ioServer. In 
entrambi i progetti referenziate l'oggetto 
Winsock. NeirioClient referenziate anche la 
libreria del CommonDialog. 



Fig. 5: La Form del Client in fase di progettazione 

3 Sulla Form di ioServer oltre al controllo 
Winsock (nominato WskServer), predi- 
sponete i seguenti elementi: una listbox per 
mostrare gli eventi della trasmissione, cioè 
quale client si connette, che file invia ecc; 
due pulsanti nominati Disconnetti e Cancella 
che rispettivamente permettono di discon- 
nettere il Client connesso e di cancellare la 
lista degli eventi. Inoltre anche in questo 
caso prevedete una label per visualizzare lo 
stato del Server. Disponete il tutto come nella 
figura 6. 




t Annulla Applica 



Fig. 4: Il componente Winsock 

2 Sulla Form di ioClient oltre al controllo 
Winsock (nominato WskClient) predispo- 
nete i seguenti elementi: due textbox per speci- 
ficare una directory e TIP del Server; un con- 
trollo CommonDialog, due pulsanti (nominati 
cerca ed invia) e un textbox (nominato txtfile). 
Questi elementi sono utilizzati per selezionare 
ed inviare i file al Server. Infine prevedete un 
altro pulsante (nominato connetti) e due label 
(nominate labelstato e labelbyte) che utilizze- 
remo per connetterci al Server e per mostrare 
lo stato della connessione e il numero di byte 
inviati. Disponete il tutto come nella figura 5. 



Fig. 6: La Form del Server in fase di progettazione 



OSA E UN WEB SERVICE ? 





isaar 
Basic 



I web service sono i nuovi 
protagonisti dell'informatica 
distribuita. I web service 
possono essere utilizzati per 
vari scopi, da semplici 
contenitori/fornitori di 
informazioni di utilità generale 
(previsioni meteorologiche, 
annunci di vario tipo, ecc), a 
veri e propri servizi stand-alone 
o integrabili in altre 
applicazioni. Alle funzionalità 
offerte dai web service si può 



accedere con dei client che 
utilizzano il protocollo SOAP 
(Simple Object Access Protocol). 
Il protocollo SOAP è concepito 
per standardizzare lo scambio 
di messaggi tra computer e 
web service, esso non è legato 
ad un particolare linguaggio di 
programmazione o sistema 
operativo. Gli elementi 
fondanti del SOAP sono il 
Remote Procedure Calls (RPC), il 
protocollo HTTP e l'XML. 
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4 Iniziamo a presentare il codice del proget- 
to ioServer. In particolare vediamo le 
dichiarazioni e la Form_Load. 



Dim FileDest As String 



Dim ByteRivevuti As Long 



Dim numfile As Integer 



Dim nomeclient As String 



Private Sub Form_l_oad() 



WskServer. Protocol = sckTCPProtocol 



WskServer.LocalPort = 1023 



WskServer. Listen 



labelstate = "In ascolto" 



disconnetti. Visible = False 



End Sub 

Con il codice precedente oltre a mettere il Server 
in Listen, s'imposta il protocollo e la porta da cui 
il Server riceverà i dati. Nel nostro caso impostia- 
mo una LocalPort dato che il Server e il Client si 
trovano sullo stesso Computer. 

511 Server per gestire le richieste del Client uti- 
lizza gli eventi WskServer_Connection 
Request e WskServer_DataArrival. In particolare 
con il primo accetta la richiesta di connessione 
del Client ed invia il messaggio MSG-OKC: 
descritto in tabella 1. Nell'altro evento, invece, 
elabora i messaggi inviati dal Client e predispone 
le azioni per soddisfare le sue richieste. Tra l'altro 
invia i messaggi MSG-OKI: e MSG-RIC:. 

Private Sub WskServer_ConnectionRequest( _ 
ByVal requestlD As Long) 

If WskServer. State <> sckCIosed Then 

WskServer.Close 

WskServer.LocalPort = 1023 

WskServer. Protocol = sckTCPProtocol 

WskServer.Accept requestlD 

WskServer.SendData "MSG-OKC:" 

End Sub 



Facciamo notare che le istruzioni in 
ConnectionRequest non sono ridondanti ma 
necessarie, dato che nell'Help di VB c'è scritto 
"è consigliabile utilizzare il metodo Accept in 
una nuova istanza del controllo anziché nel 



HE COSA VUOL DIRE LA SIGLA SSL? 



SSL è il più comune protocollo 
(client/server) di sicurezza 
adoperato sulla rete. SSL per 
proteggere i dati, utilizza una 
combinazione di certificati 
digitali (chiave 
pubbliche/private) e 
crittografia. I certificati 



ammessi possono essere 
sviluppati secondo vari 
standard, tra cui lo standard 
X.509. Naturalmente anche 
Internet Explorer utilizza SSL, 
controllate la scheda 
Contenuto della maschera 
Opzioni Internet. 



J 



controllo in attesa" 

Private Sub WskServer_DataArrival 

(ByVal bytesTotalAs Long) 
Dim Buffer As String 
Dim Risp As Integer 
On Error GoTo Errore 



WskServer. GetData Buffer 



Select Case Left( Buffer, 8) 



Case "MSG-CLN:" 'nome client 



nomeclient = Right(Buffer, Len(Buffer) - 8) 
Listi. Addltem "Client con ID " + nomeclient + " 

Connesso" 
disconnetti. Visible = True 
Case "MSG-EOF:" 'fine del file 
Listi. Addltem "Client con ID " + nomeclient _ 



& " Byte ricevuti " & ByteRivevuti 
Close #numfile 

Listi. Addltem "Client con ID " _ 
& nomeclient + " fine trasmissione" 
Case "MSG-DES:" 'nome file destinazione 
FileDest = Right(Buffer, Len(Buffer) - 8) 
numfile = FreeFile 
On Error Resumé Next 
If Len(Dir(FileDest)) > Then 
Risp = MsgBox("II file esiste sostituisco?", _ 
vbCritical + vbQuestion + vbYesNo, "Server") 
If Risp = vbYes Then 
Kill FileDest 

Else 

'inviare errore al Client 
Unload Me 
End If 
End If 

Open FileDest For Binary As #numfile 
Listi. Addltem "Client con Id " _ 
& nomeclient + " destinazione file: " + FileDest 
WskServer.SendData "MSG-OKI:" 
Case Else 

ByteRivevuti = ByteRivevuti + Len(Buffer) 
Put #numfile, , Buffer 
WskServer.SendData "MSG-RIC:" 
End Select 
Exit Sub 
Errore: 
MsgBox Err.Description, vbCritical, "Server" 
Unload Me 
End Sub 



6 



Il Server per disconnettere il Client e puli- 
re la ListBox utilizza il seguente codice. 



Private Sub disconnetti_Click() 



labelstate = "In ascolto" 



disconnetti. Visible = False 



Listi. Clear 



WskServer.SendData "MSG-CLC: 
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WskServer_Close 



End Sub 



Private Sub WskServer_Close() 



Listi. Addltem "Client con ID " 



& nomeclient + " Connessione chiusa" 



WskServer.Close 



Form_l_oad 



End Sub 



Private Sub Cancella_Click() 



Listi. Clear 



End Sub 

Nella Disconnetti notate l'invio del messag 
gio MSG-CLC: 



inizialmente impostata su Connetti, è cam- 
biata in Disconnetti dopo che il Server ha 
accettato la connessione. Inoltre notate che 
nella ConnettiServer, il Client capisce che il 
Server ha accettato la sua richiesta controllan- 
do il valore del Flag HaRisposto che è impo- 
stato nella WskCliente_DataArrival descritta 
nel punto successivo. Il Client dopo aver con- 
statato ciò invia il suo nome con il messaggio 
MSG-CLN:. 

811 Client (come nel caso del Server) utilizza 
l'evento WskCliente_DataArrival per elabo- 
rare i messaggi inviati dal Server, di seguito il 
codice. 



7 Ora passiamo al Client. Di seguito presentia- 
mo le parti principali del progetto. In parti- 
colare la parte di codice che gestisce la richiesta 
di una connessione è composta dalla connet- 
ti_Click e dalla ConnettiServer riportate di 
seguito. 

Private Sub connetti_Click() 
If connetti. Caption = "Connetti" Then 
ConnettiServer 

Else 

WskCIiente.Close 
Form_Load 

End If 

End Sub 



Private Sub ConnettiServerQ 



On Error GoTo errore 



Dim Contr As Long 



If WskCIiente. State <> sckCIosed Then 

WskCIiente.Close 
WskCIiente. Connect Me.txtipserver, 1023 



Contr = 



While (Not HaRisposto) And (Contr < 100000) 



DoEvents 



Contr = Contr + 1 



Wend 



If Contr >= 100000 Then 



MsgBox "Non è possibile connettersi al 

Server", vbCritical, "Client" 
WskCIiente.Close 



Exit Sub 



End If 



WskCIiente. SendData "MSG-CLN:" + 

App.EXEName 
Me. connetti. Caption = "Disconnetti" 



Exit Sub 



MsgBox Err.Description 



End Sub 



Notate che la Caption del pulsante Connetti, 



Private Sub WskCliente_DataArrival . 

(ByVal bytesTotal As Long) 
Dim recBuffer As String 
WskCIiente. GetData recBuffer 



Select Case Left( recBuffer, 8) 



Case "MSG-RIC:" 'Blocco ricevuto 



Ricevuto = True 



Case "MSG-OKC:" 'Ok connesso 



HaRisposto = True 



Case "MSG-OKI:" 'Ok puoi iniziare ad inviare 



InviaFile 



Case "MSG-CLC:" 'connessione closed 



WskCliente_Close 



Unload Me 



Case "Msg-Err:" 'errore 



'non gestito 



End Select 



End Sub 



CONCLUSIONE 

Abbiamo introdotto le principali tecniche 
per la creazione di applicazioni Client-Server 
per Internet. Nello spazio a disposizione però 
non abbiamo potuto illustrare tutto il codice 
del progetto Client che trovate nel CD allega- 
to alla rivista. 

Massimo Autiero 



FILE TRANSFER PROTOCOL IN BREVE 



In una configurazione 
Client/Server FTP, il Server è un 
sistema in cui sono archiviati dei 
file che possono essere 
manipolati, in remoto, con un 
FTP Client. Sul Server FTP sono 
definiti gli Account dei Client. I 
Client FTP dopo aver specificato 
Username e Password possono 



accedere, in lettura/scrittura, ad 
una parte oppure a tutte 
(dipende dal tipo di Account) le 
directory del Server. Su alcuni 
Server, di solito, è definito 
l'account anonymous (con 
password un indirizzo di posta 
elettronica o guest) che contiene 
le directory pubbliche del Sito. 
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COSTRUIRE UNO 



SKYPEBOT 



SE VI PIACE SKYPE, PREPARATEVI A DIVENTARNE AMICI INTIMI. IN QUESTO ARTICOLO 
SCRIVEREMO UN PROGRAMMA CHE RISPONDE Al MESSAGGI DI CHAT USANDO LE API 
PUBBLICHE DI SKYPE E IL LINGUAGGIO RUBY. 




^ REQUISITI 



u Basi 



di programmazione 



& 



Windows, Skype, 
Skype4COM, Ruby. 



000 



Tempo di realizzazione 



Siete pronti a fare una scorpacciata di pro- 
grammazione? Questo articolo mette 
parecchia carne al fuoco: Skype, il linguag- 
gio Ruby, gli oggetti COM, i Web Service... Alla 
fine vi servirà del bicarbonato, ma sono certo che 
vi divertirete molto. Staccate il telefono, chiudete 
a chiave la porta e cominciamo! 



L'APPLICAZIONE CHE FA 
PARLARE LA GENTE 

Cominciamo da Skype. Esistono delle API pub- 
bliche per estendere il client di Skype 
(https://developer.skype.com/DevZone), ma 
purtroppo non per accedere direttamente al ser- 
ver. Per fortuna le API del client sono sufficienti 
per scrivere programmi interessanti come gli 
SkypeBot. Uno SkypeBot è un programma che 
fingere di essere un utente di Skype. Di solito 
intercetta i messaggi in arrivo e risponde a tono. 
In questo articolo scriveremo uno SkypeBot che 
cerca di rendersi utile fornendo un semplice ser- 
vizio di conversione. 

Le API standard di Skype richiedono il linguaggio 
C, ma esistono valide alternative. Esiste un wrap- 
per Java delle API, e anche un wrapper COM che 
espone il client di Skype come un oggetto 
Windows. Noi useremo quest'ultimo 
(Skype4C0M) per accedere alle API con un lin- 
guaggio script. Dopo aver installato Skype, usate 
skype_contacts.exe, che troverete sul CD per 
installare i controlli ActiveX. La documentazione 
dice di registrare il server COM, ma in realtà l'in- 
staller dovrebbe pensarci da solo. Se qualcosa va 
storto e volete registrare manualmente la DLL, 
andate nella directory Skype\ActiveX\Contacts e 
date il comando: 

regsvr32 /u skype4com.dll 

Ora Skype è disponibile come un oggetto COM. 
Ci serve solo un buon linguaggio per parlargli. 



UN GIOIELLINO 
DI LINGUAGGIO 

Ruby è un linguaggio script completamente 
object-oriented, semplice, produttivo e diverten- 
te. Per leggere questo articolo dovete avere delle 
buone basi di programmazione, ma non è neces- 
sario che conosciate già Ruby o la programma- 
zione object-oriented. Non vi sarà difficile segui- 
re gli esempi, soprattutto se avete già usato PHP 
o Perl. Installate Rubylnstaller per Windows, che 
troverete sul CD. L'installer contiene il linguaggio 
e una serie di utility, incluso FreeRIDE (un IDE 
per Ruby) e SciTE (un semplice editor con sintas- 
si colorata) . 

Durante i primi esperimenti vi conviene tenere 
aperto l'interprete irb, che permette di eseguire 
dei comandi e vedere immediatamente il risulta- 
to. Se scoprite di non riuscire a scrivere alcuni 
caratteri in irb (a me succede con le parentesi 
quadre della mia tastiera italiana), lanciatelo con 
lo switch noreadline: 

irb —noreadline 

Potete usare qualsiasi editor per scrivere i file Ruby, 
che sono file di testo con estensione .rb. Se volete 
un editor fatto apposta, usate SciTE. SciTE lancia lo 
script quando si preme F5. Se preferite lanciare uno 
script dalla riga di comando, scrivete: 

ruby <nome_del_file> 

È arrivato il momento di sporcarsi le mani con un 
po' di codice 



MICROCORSO: RUBY 
E WINDOWS OLE 

Siete pronti per un corso ultrarapido di program- 
mazione Windows in Ruby? Impareremo come 
mandare messaggi ad un oggetto COM da Ruby e 
come ricevere eventi dall'oggetto. Durata totale 
del corso: 15 minuti abbondanti. 
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Come oggetto COM useremo il buon vecchio 
Internet Explorer. Scrivete e lanciate questo 
script Ruby: 

require 'win32ole' 

ie =WIN320LE.new('InternetExplorer. Application') 

ie.visible = true 

ie.navigate('http://www. google, co.jp') 



righe allo script: 

ev = WIN320LE_EVENT.new(ie, 

'DWebBrowserEvents') 
ev.on_event("NavigateComplete") { | uri | 
print uri, "\n" 

} 

loop { WIN320LE_EVENT.message_loop } 




Internet Explorer dovrebbe aprirsi e accedere alla 
pagina giapponese di Google. Vediamo riga per 
riga come funziona lo script: 

require 'win32ole' 

L'istruzione require esegue un file di nome 
win32ole.rb, che fa parte delle librerie del lin- 
guaggio. Non solo il codice viene eseguito, ma 
tutte le variabili e le funzioni ivi definite diventa- 
no visibili dallo script (da mesi sognavo di usare 
la parola "ivi" in un articolo). Il file definisce tra 
l'altro una classe che si chiama WIN320LE e tra- 
sforma oggetti Windows in oggetti Ruby. Ora pos- 
siamo usare il metodo new per vedere l'Internet 
Explorer come un oggetto Ruby: 

ie = WIN320LE.new('InternetExplorer.Application') 

Il parametro del new è una stringa che contiene 
l'identificativo dell'oggetto COM. Una stringa in 
Ruby può essere delimitata sia da singoli apici 
che da virgolette. 

Se non siete abituati alla programmazione a 
oggetti, tutto questo parlare di metodi e classi 
potrebbe confondervi. L'unica cosa che dovete 
sapere per seguire questi esempi è che un ogget- 
to si crea con il metodo new e possiede delle pro- 
prietà e dei metodi. Le proprietà sono simili ai 
campi di una struct in C. Ad esempio, l'oggetto ie 
ha una proprietà booleana visible. Se visible è 
true, allora la finestra di Internet Explorer è visi- 
bile: 

ie.visible = true 

I metodi sono dei comandi che possiamo chia- 
mare in modo simile alle funzioni. Ad esempio, 
Internet Explorer ha un metodo navigate che 
apre una URL: 

ie.navigate('http://www. google, co.jp') 

Come vedete, parlare agli oggetti COM con Ruby 
è facile. Ma a volte vorremmo che fossero loro a 
parlare a noi. Per fare questo possiamo metterci 
in ascolto per ricevere eventi dall'oggetto. Per 
ricevere un evento quando qualcuno apre una 
URL in Internet Explorer, aggiungete queste 



La prima riga usa la classe WIN320LE_EVENT 
delle librerie win32ole per creare un oggetto 
che riceve gli eventi del browser. 
DWebBrowser Events è una delle interfacce 
messe a disposizione da Internet Explorer per 
gestire gli eventi (per scoprirlo abbiamo dovu- 
to consultare la complicatissima documenta- 
zione di Internet Explorer sul sito di 
Microsoft). Uno degli eventi, NavigateComplete, 
segnala che Explorer ha aperto una nuova 
pagina. Quando riceviamo l'evento, vogliamo 
stampare la URL della pagina sullo schermo. 
Il codice per ottenere questo risultato è un po' 
complicato, e merita uno sguardo attento. 
Il metodo on_event prende come parametro il 
nome dell'evento che vogliamo ricevere. 
Quello che segue, delimitato da parentesi 
graffe, è un costrutto Ruby che non esiste 
nella maggior parte degli altri linguaggi: un 
blocco. Non abbiamo spazio in questo artico- 
lo per imparare bene cosa sono e come fun- 
zionano, ma in questo caso possiamo sempli- 
cemente pensare al blocco come ad un "cali- 
back". Questo codice dice: "quando arriva un 
evento NavigateComplete, chiama questo 
blocco passandogli come parametro la URL 
appena aperta". Il codice del blocco stampa la 
URL sullo schermo, seguita da un carattere di 
a-capo. 

Ora dobbiamo solo attendere che Internet 
Explorer ci mandi i suoi eventi. Ci serve un 
ciclo infinito, altrimenti il programma termi- 
na subito anziché restare in ascolto. Ma se 
vogliamo "consumare" gli eventi in arrivo, il 
ciclo infinito non basta. Dobbiamo anche ese- 
guire continuamente il "message loop" di 
Windows: 

loop { WIN320LE_EVENT.message_loop } 




I TUOI APPUNTI 



ALTA VELOCITA 



Il linguaggio Ruby 
(http://www.ruby-lang.org) è in 
circolazione da qualche anno, ma 
solo recentemente è diventato una 
star. Merito soprattutto di Ruby On 
Rails (http://www.rubyonrails.org). 



un f ramework per la 
programmazione Web talmente 
semplice e produttivo da sembrare 
magico. Parleremo in dettaglio di 
"Ruby su Rotaie" nei prossimi 
numeri di loProgrammo. 
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La parola loop dice a Ruby di eseguire per sem- 
pre il codice tra parentesi graffe, finché non 
interromperete l'esecuzione del programma. 
Provate a lanciare questo script e visitate un po' 
di pagine in Internet Explorer. 
I nomi delle URL dovrebbero apparire sullo 
schermo. Se tutto funziona, ne sapete abbastan- 
za per affrontare le API di Skype. 



IL PAPPAGALLO 
CAPOVOLTO 

E' il momento di scrivere un semplice SkypeBot. 
Per seguire le chiamate alle API Skype4COM, 
potete tenere aperta la documentazione online 
all'indirizzo https://developer.skype.com/Docs 
/Slcype4COMLib. 



require 


'win32ole' 




skype = 


WIN320LE.new("Skype4COM. Skype") 


skype. Client. Start if 


Iskype. Client. IsRunning 


skype. Attach 



ALZATI, MIA CREATURA! 



Lo SkypeBot intercetterà i messaggi riservati all'utente che ha fatto login 
sul client di Skype. Purtroppo è possibile eseguire un solo client su ciascun 
computer, quindi servono due computer (o l'aiuto di un amico) per 
provare comodamente lo SkypeBot. Ecco come fare: 



1 - Lanciate Skype. Potete 
usare il vostro utente 
ufficiale, o creare un nuovo 
utente apposta per lo 
SkypeBot. Per disconnettere 
l'utente esistente e crearne 
uno nuovo, usate la voce 
Chiudi Collegamento del 
menu File, e poi cliccate su 
"Non hai un nome utente 
Skype?". Occhio a non 
dimenticare la password del 
vostro vero utente! 

2 - Lanciate lo SkypeBot. 




Ep^ 



C:\eclipse_workspaces\default\SkypeBot>ruby skype_bot .rb 



3 - Da un altro computer, usate Skype per mandare messaggi al bot. Tutti i 
messaggi in ingresso e in uscita saranno mostrati dal client di Skype nella 
solita finestra di chat. In alternativa potete provare il bot dallo stesso 
computer cambiando continuamente l'utente, e lanciando e fermando lo 
SkypeBot. 



MESSAGE_STATUS_RECEIVED = 

skype. Convert.TextToChatMessageStatus 

("RECEIVED") 

MESSAGE_TYPE_SAID = 

skype. Convert.TextToChatMessageType("SAID") 

ev = WIN32QLE_EVENT.new(skype) 

ev.on_event('MessageStatus') {|msg, status| 
if status == MESSAGE_STATUS_RECEIVED && 

msg.Type == MESSAGE_TYPE_SAID 

skype. SendMessage(msg.FromHandle, 

msg. Body, reverse) 
end 

_} 

loop { WIN320LE_EVENT.message_loop } 



Esaminiamo il bot riga per riga: 



require 'win32ole' 



skype = WIN320LE.new("Skype4COM. Skype") 

Abbiamo usato win32ole per istanziare un ogget- 
to che permette di mandare messaggi a Skype. 
Poi ci assicuriamo che il client di Skype sia aper- 
to: 

skype. Client. Start if Iskype. Client. IsRunning 

Questa riga si legge "lancia il client di Skype se 
non sta già girando". 

Start e IsRunning sono entrambi metodi dell'og- 
getto Client delle API. In Ruby, a differenza di 
molti altri linguaggi, le parentesi tonde nella 
chiamata di un metodo sono opzionali, e in que- 
sto caso le abbiamo omesse. Avremmo anche 
potuto scrivere: 

skype. Client. Start() if Iskype. Client. IsRunning() 

L'if si può anche mettere prima della condizione 
come nella maggior parte dei linguaggi, ma in 
questo caso si deve usare end per chiudere il 
blocco di istruzioni: 

if Iskype. Client. IsRunning 

skype. Client. Start 
end 

Ora che sia, certi che il client di Skype stia giran- 
do, attacchiamoci a lui come simpatici parassiti: 

skype. Attach 

Le righe successive servono a definire due 
costanti che torneranno utili tra poco: 

MESSAGE_STATUS_RECEIVED = 

Skype. Convert.TextToChatMessageStatus 
("RECEIVED") 
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MESSAGE_TYPE_SAID = 

skype. Convert.TextToChatMessageType("SAID") 

Per definire una costante in Ruby basta usare un 
nome che inizia con una lettera maiuscola. Per 
convenzione si usano solo lettere maiuscole, e si 
separano le parole con degli underscore. 
Lo stato di un messaggio è "RECEIVED" per i 
messaggi ricevuti, e il tipo di un messaggio è 
"SAID" per i normali messaggi di chat, "SETTO - 
PIC" per i messaggi che cambiano il titolo della 
chat (quelli inviati attraverso il comando skype 
/topic), eccetera. 

Noi siamo interessati ai messaggi di chat in 
ingresso, e abbiamo usato l'oggetto Convert di 
Skype per convertire le stringhe identificative di 
questi stati nelle relative costanti. Passiamo agli 
eventi: 

ev = WIN320LE_EVENT.new(skype) 
ev.on_event('MessageStatus') {|msg, status| 
if status == MESSAGE_STATUS_RECEIVED && 

msg.Type == MESSAGE_TYPE_SAID 

skype. SendMessage(msg.FromHandle, 

msg. Body, reverse) 
end 

_} 

loop { WIN320LE_EVENT.message_loop } 



MICROCORSO: RUBY 
E I WEB SERVICE 

Non siete stanchi, vero? E' il momento di un 
nuovo microcorso. Titolo: "Come connettersi 
ad un Web Service da Ruby". Durata: 10 minu- 
ti. Se sapete già cos'è un WSDL, potete saltare 
il prossimo paragrafo. 

Un Web Service (che d'ora in poi chiameremo 
WS) è un servizio accessibile da un program- 
ma tramite HTTP. Esempi classici sono un 
validatore di carte di credito, o un report del- 
l'andamento delle borse. Un WS pubblica la 
propria interfaccia con un linguaggio basato 
su XML che si chiama WSDL (Web Service 
Description Language). Il WSDL può specifi- 
care ad esempio che il WS fornisce una proce- 
dura chiamata weather_report } che restituisce 
le previsioni del tempo per una certa città. Se 
passo al WS il nome della città, lui mi rispon- 
de con le previsioni. Ma per scambiare questi 
dati tra client e WS li devo codificare con qual- 
che standard. Di solito si usa SOAP (Simple 
Object Access Protocol), un altro standard 
basato su XML. 

Per prima cosa dobbiamo trovare un WS che 
ci piace. Ne useremo uno che fa le conversio- 
ni di valuta in tempo reale. Il WSDL è all'indi- 
rizzo: 




La gestione degli eventi e il loop infinito sono 
simili a quelli dell'esempio nel paragrafo pre- 
cedente. Questa volta restiamo in attesa del- 
l'evento MessageStatus, generato da Skype 
ogni volta che succede qualcosa che riguarda 
un messaggio. L'evento ha due argomenti: un 
messaggio (un oggetto ChatMessage di Skype) 
e uno status. Quando riceviamo l'evento, ana- 
lizziamo il messaggio e lo status: se si tratta di 
un messaggio di chat in arrivo, allora rispon- 
diamo con il metodo SendMessage di Skype. 
SendMessage prende come argomenti il desti- 
natario del messaggio (che è il mittente del 
messaggio precedente, ottenuto con il meto- 
do FromHandlé) e il corpo del messaggio (che 
è lo stesso del messaggio precedente, ottenu- 
to con il metodo Body). Per rendere le cose più 
interessanti abbiamo invertito il corpo del 
messaggio, che è una normale stringa, con il 
metodo reverse delle stringhe di Ruby. 
Il box Alzati, mia creatura! spiega come lan- 
ciare e usare lo SkypeBot. Se provate a man- 
dare un messaggio al bot: 

Salve! 

lui risponderà con lo stesso messaggio invertito: 

levlaS 



http://www.xmethods.net/sd/ 

CurrencyExchangeService.wsdl 

Questo WSDL mostra che il Web Service accetta 
un messaggio chiamato getRate, che prende due 
codici di valuta e restituisce il tasso di cambio. 
Ecco un programmino Ruby che accede al servi- 
zio e stampa il tasso di conversione tra Euro e 
dollaro: 

require 'soap/wsdlDriver' 
driver_factory = 

SOAP: : WSDLDriverFactory. new("http://www. 
xmethods.net/sd/CurrencyExchangeService.wsdl") 
soap = driver_factory.create_driver 
print "Euro/dollaro: ", soap.getRate("euro", "usd") 

La prima riga importa nel programma la libre- 
ria standard di Ruby per l'accesso ai WS. 
Questa libreria definisce WSDLDriverFactory, 
un oggetto che è in grado di interpretare un 
WSDL. La seconda riga crea una nuova 
WSDLDriverFactory. La terza riga usa la fac- 
tory per creare un oggetto che riceve tutti i 
messaggi definiti nel WSDL. Il risultato è un 
normale oggetto con i suoi metodi. Quando 
chiamate un metodo, in realtà state facendo 
una chiamata al WS. Riassumendo: prima 
abbiamo "avvolto" il WSDL in un oggetto che 
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sa come leggerlo e sa anche come costruisci 
attorno degli oggetti Ruby (una "fabbrica"); 
poi abbiamo usato questa fabbrica per creare 
un oggetto che riceve i nostri messaggi e li tra- 
smette al WS. 

Ora possiamo usare questo nuovo oggetto. Se ne 
occupa la quarta riga, che chiama il metodo 
getRate passando come parametri i codici di 
valuta per l'Euro e il dollaro USA. Il risultato è il 
tasso di cambio, che viene stampato sullo scher- 
mo (sempre che il Web Service sia disponibile). 
Mentre scrivo, un Euro vale 1,2735 dollari. Se non 
fosse per l'IVA, la dogana e le spese di spedizione, 
sarebbe il momento giusto per acquistare online 
dagli Stati Uniti. 

E tutta la faccenda della codifica dei dati in 
SOAP? Ci pensa Ruby, voi non dovete preoccu- 
parcene. Quindi il microcorso su come accedere 
ai Web Service in Ruby è finito. Mettiamo a frutto 
quello che abbiamo imparato. 



Ul\l ALTRO PO 1 DI RUBY 

Ecco uno script Ruby che usa lo stesso Web 
Service del paragrafo precedente per convertire 
un importo di denaro da una valuta all'altra: 



def nome_della_funzione(argomentol, 



argomento2, ...) 



require 'soap/wsdIDriver' 



currencies = SOAP: :WSDLDriverFactory. 
new("http://www. xmethods.net/sd/ 

CurrencyExchangeService.wsdl"). 



create_rpc_driver 



def convert_money(msg) 



begin 



amount, from, ignored, to = msg.split(' ') 
rate = currencies. getRate(from, to) 
return [amount, from, "equivalgono a", 

amount. to_i * rate, to].join(' ') 



return "Esempio: 100 euro -> us" 
end 
end 

Il codice per accedere al WS è più o meno lo stes- 
so di prima, e verrà eseguito la prima volta che lo 
script viene eseguito o caricato con require. 
Questa volta non abbiamo perso tempo a mette- 
re la factory in una variabile temporanea: la 
creiamo, la usiamo per creare un oggetto curren- 
cies e poi la abbandoniamo al suo destino. Ruby 
permette di spezzare le righe con degli a-capo 
(con qualche limitazione), così evitiamo di offu- 
scare il codice con righe troppo lunghe. 
Poi lo script definisce una funzione 
convert_money che usa l'oggetto currencies. 
Una funzione in Ruby si definisce così: 



codice_della_funzione 



end 



La funzione convert_money riceve un messaggio 
che contiene l'importo e le valute, lo analizza 
rozzamente, lo usa per mandare i parametri al 
convertitore e restituisce il tasso di cambio. 
Osserviamo meglio le tre righe centrali della fun- 
zione: 

amount, from, ignored, to = msg.split(' ') 

Per prima cosa parliamo di quello che c'è a 
destra dell'assegnamento. Il metodo split spez- 
za la stringa in un array di stringhe più piccole 
usando un carattere di separazione - in questo 
caso uno spazio. Abbiamo fatto l'ipotesi che il 
messaggio sia costituito da quattro "parole" 
separate da spazi, quindi il risultato dello split 
sarà un array di quattro stringhe. Questo array 
viene assegnato a quattro variabili. L'astuto 
Ruby farà la cosa giusta, e assegnerà a ciascuna 
variabile il corrispondente elemento dell' array: 
il primo elemento finisce in amount, il secon- 
do in from, e così via. Se il messaggio non con- 
tiene esattamente quattro parole avremo un 
errore. Ne parleremo tra poco. 
Ora abbiamo due variabili {from e to) che sono 
le due valute tra cui convertire, una [amount] 
che è l'importo di denaro, e una [ignored] che 
non serve a nulla, e possiamo appunto ignora- 
re. La riga successiva usa il convertitore per 
ottenere il tasso di cambio: 

rate = currencies. getRate(from, to) 

Ora possiamo restituire una stringa che dà il 
risultato dell ' op erazione : 

return [amount, from, "equivalgono a", amount. to_i 

* rate, to].join(' ') 

Il risultato è una semplice stringa, che avremmo 
potuto costruire in modo più tradizionale - ma 
questa riga inutilmente virtuosistica ci dà la 
scusa per parlare un altro po' di Ruby. La roba tra 
parentesi quadre è un array definito al volo, che 
contiene i "pezzi" della stringa che vogliamo 
restituire al chiamante. L'elemento più impor- 
tante è: 

amount. to_i * rate 

La variabile amount (che, lo ricordiamo, è una 
stringa) viene convertita in un intero con il 
metodo to_i e moltiplicata per il tasso di cam- 
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bio per ottenere l'importo finale. 
Il metodo join degli array è il contrario del 
metodo split delle stringhe: concatena tutti gli 
elementi in una stringa, usando come separa- 
tore il carattere che gli passiamo. Quindi: 

[10, "euro", "equivalgono a", 100, "pizze di fango del 

camerun"].join(' ') 

ha come risultato: 

10 euro equivalgono a 100 pizze di fango del 

camerun 

I programmatori sono bravi ad immaginare 
modi in cui le cose possono andare storte, 
quindi sicuramente vi saranno venuti in 
mente molti scenari orribili. 
La prima parola del messaggio potrebbe dare 
un errore quando cerchiamo di convertirla in 
numero; la seconda potrebbe non essere un 
codice di valuta, e causare un errore nella 
chiamata al Web Service; o magari il WS 
potrebbe essere non disponibile. In casi come 
questi avremo qualche tipo di errore. 
La funzione convert_money gestisce gli errori 
in modo estremamente rozzo, con un blocco 
begin-rescue-end. Se si verifica un errore nel 
codice compreso tra begìn e rescue, l'esecu- 
zione del programma salta al codice compre- 
so tra rescue e end. Se tutto va bene, questo 
codice non viene mai eseguito. 



begin 


<codice che può generare errori> 


rescue 


<codice da eseguire in caso di errore> 


end 



Nel nostro caso l'errore viene "gestito" rispon- 
dendo al chiamante con una stringa che spie- 
ga come comporre un messaggio valido. 
Questo modo allegro di gestire gli errori 
sarebbe inaccettabile in un programma in 
produzione, per parecchi motivi. 
Se il messaggio è scritto bene ma il Web 
Service non funziona, l'utente riceve una 
risposta frustrante che lo colpevolizza senza 
ragione; la terza parola del messaggio viene 
ignorata, quindi può contenere qualsiasi schi- 
fezza; non abbiamo verificato che la libreria 
soap/wsdlDriver supporti la concorrenza, 
quindi non sappiamo se la funzione process 
può essere chiamata con sicurezza da più 
thread in parallelo; e così via dubitando. Ma 
dato che gestire bene gli errori richiede tempo 
e spazio, teniamoci questo semplice esempio 
così com'è. Se mai rivenderete questo pro- 



gramma, vi raccomando di scrivere una 
gestione degli errori più solida (e di presentar- 
mi i vostri clienti). Salvate lo script in un file di 
nome currency_converter.rb. Come al solito lo 
si può importare con un require: 

require 'currency_converter' 

Quando lo importiamo, lo script viene eseguito e 
inizializza la variabile currencies. A questo punto 
possiamo chiamare la funzione convertjnoney 
(con un messaggio nel formato che abbiamo 
detto) per fare una conversione di valuta. Provate 
a lanciare irb, importare lo script e chiamare la 
funzione: 

print convert_money("100 euro -> us") 

Ora abbiamo tutto quello che ci serve per inseri- 
re un cambiavaluta nel nostro SkypeBot. 



METTERE INSIEME 
I PEZZI 

Bastano un paio di modifiche per trasformare l'i- 
nutile EchoBot in uno SkypeBot più dignitoso: 

require 'win32ole' 

require 'currency_converter' 

ev.on_event('MessageStatus') {|msg, status] 
if status == message_status_received && 

msg.Type == message_type_said 
skype. SendMessage(msg.FromHandle, 

convert_money(msg.Body)) 

end 

_> 

Niente male, come inizio. Ora si potrebbe 
aggiungere un comando per chiedere al bot le 
quotazioni di borsa, naturalmente dopo aver 
trovato un web service adeguato. 
Naturalmente si dovrebbe scrivere del codice 
per distinguere tra i vari comandi, in modo da 
poter usare sia il cambiavaluta che le quota- 
zioni. E naturalmente non dovete limitarvi a 
bot che rispondono a semplici comandi di 
chat. Con un po' di fantasia e le API di Skype 
potreste ad esempio scrivere una "sveglia 
automatica" che vi fa una telefonata ad un'o- 
ra predefinita per ricordarvi che è ora di stac- 
carvi dal PC. Sono sicuro che avete già idee 
migliore di queste, quindi vi lascio ai vostri 
esperimenti. Buon divertimento con le API di 
Skype! 

Paolo Perrotta 





SE IL WEB 
SERVICE VA GIÙ 

I Web Service vanno e 
vengono. Il 
convertitore di valuta 
che abbiamo usato per 
i nostri esempi 
potrebbe non essere 
più disponibile quando 
leggerete questo 
articolo. 

Semplicemente cercate 
qualche altro WS 
semplice e modificate 
un po' il codice. Il WS 
ideale non dovrebbe 
richiedere 
autenticazione e 
dovrebbe avere 
almeno una chiamata 
che restituisce una 
semplice stringa. 
Potrete esplorare siti 
come 

http://www.webservice 
list.com per trovare 
nuovi giocattoli. 
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UN PLUGIN PER 
GOOGLE DESKTOP 

LI CHIAMANO GADGET! I PICCOLI PLUGIN CHE ESTENDONO LA PIÙ NOTA APPLICAZIONE 
PER LA RICERCA DI CONTENUTI "OFF-LINE". IMPARIAMO A COSTRUIRNE UNO CHE CI 
MOSTRA LA LISTA DEI "TASK" DA ESEGUIRE NEL CORSO DELLA GIORNATA 




%T REQUISITI 



■ miii mii'ii'i ^m 

programmazione in C# 



t 



NET Framework 2.0, 
Visual Studio 2005, 
Google Desktop SDK 




Sono ormai numerose le applicazioni che 
consentono l'indicizzazione del contenuto 
dei nostri hard disk al fine di garantire fun- 
zionalità di ricerca veloci ed immediate: 
Microsoft con Windows Desktop Search e Yahoo! 
Desktop Search sono tra i sistemi più diffusi. Ma 
quando si parla di motori di ricerca non può di 
certo mancare il motore di ricerca per eccellenza: 
Google. Con il suo Google Desktop Search il 
gigante di Mountain View entra a pieno titolo, e 
per la prima volta, nel mondo desktop. Google 
Desktop Search, oltre ad integrarsi pienamente 
con il motore di ricerca web e con la sua interfac- 
cia, non si limita solo a fornire avanzate funzio- 
nalità di ricerca, ma fornisce anche una comoda 
sidebar costituita da un insieme di plugin, chia- 
mati gadget, le cui funzionalità possono essere 
facilmente estese. In questo articolo impareremo 
a creare un plug-in per la sidebar di Google 
Desktop Search che consenta la rapida visualiz- 
zazione di una "task list" fornita da un nostro 
ipotetico applicativo. Purtroppo per motivi di 
spazio non sarà possibile mostrare tutto il codice 
necessario per il corretto funzionamento del plu- 
gin. Il codice completo è comunque disponibile 
nel CD allegato alla rivista. 



CREAZIONE 
DELL'AMBIENTE 

Come prima operazione dobbiamo impostare 
l'ambiente di sviluppo scaricando ed installando 
il Google Desktop SDK, il cui indirizzo è indicato 
nel box laterale. Il Google Desktop SDK installa 
esempi e documentazione per l'utilizzo delle 
API, oltre ai componenti COM che utilizzeremo 
nel nostro progetto. Apriamo Visual Studio .NET 
e creiamo un nuovo progetto Class Library in C#. 
Aggiungiamo un riferimento alle librerie 
System.Windows.Forms e alle librerie COM 
Google Desktop Display API Type Library e Google 
Desktop Search API 1.1 Type Library. Nel proget- 



to utilizzeremo anche alcune interfacce e strut- 
ture per comunicare con le classi unmanaged e 
che possiamo trovare nel file imports.cs conte- 
nuto nel CD oltre che nelle librerie dell'SDK. 



EE 


a 


id 




title 




description 




date 




done 





Fig. 1: La tabella che conterrà i nostri task 



CREAZIONE DEL PLUG IN 

Aggiungiamo al nostro progetto un nuovo file Ta- 
skPlugin.cs. Inseriamo un riferimento al name- 
space GoogleDesktopAPILib e dichiariamo una clas- 
se TaskPlugin che implementa la classe base astrat- 
ta GoogleDesktopDisplayPluginHelper Class, wrap- 
per della classe Google Desktop DisplayPluginHel- 
per contenuta nelle Google Desktop Display API, e 
le interfacce IGoogleDesktopDisplayPluginHand- 
ler, IObjectWithSite e IPersistStreamlnit: 

• GoogleDesktopDisplayPluginHelperClass: è la 
classe base astratta che fornisce tutte le fun- 
zionalità di base per la creazione di un display 
plugin o gadget; 

• IGoogleDesktopDisplayPluginHandler: è l'in- 
terfaccia che fornisce i servizi di interazione 
con gli eventi della sidebar; 

• IObjectWithSite: consente di impostare o 
recuperare il site, inteso come l'host del plu- 
gin, ed utilizzato per eventualmente gestire le 
proprietà del plugin; 

• IPersistStreamlnit: l'interfaccia consente di 
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rendere persistente lo stato del controllo e di 
ricaricarlo al successivo avvio della sidebar; 

Otteniamo quindi un codice simile a questo: 

[GuidAttribute("766bcd9b-0b64-469c-b396 

fe898eced21b")] 

public class TaskPlugin : 

GoogleDesktopDisplayPIuginHelperClass, 

IGoogleDesktopDisplayPIuginHandler, 

IObjectWithSite, 

IPersistStreamlnit 

{ 

static String controlGuid = 

"{766bcd9b-0b64-469c-b396-fe898eced21b}"; 

static String pluginName = "ioProgrammo - Task 

Plugin"; 
static String pluginDesc = "<Description>"; 



} 



Dichiariamo anche a livello di classe delle 
variabili private che utilizzeremo poi nella 
registrazione e nella deregistrazione del plugin 
nella sidebar. Nel codice riportato occorre evi- 
denziare Fuso l'attributo Guid che consente di 
registrare il plugin come oggetto COM in 
maniera univoca. Il primo passo da fare è la 
creazione dei metodi per caricare, salvare e ini- 
zializzare le impostazioni del plugin. Per que- 
sto scopo ci viene incontro l'interfaccia 
IPersistStreamlnit in particolare con i metodi 
Load, Save e InitNew. Il metodo InitNew richia- 
ma il metodo Initialize che esegue le imposta- 
zioni di base del plugin: 

private void Initialize() 

{ 

IGoogleDesktopDisplayPIuginHelper helper = 
(IGoogleDesktopDisplayPluginHelper)this; 
GoogleDesktopDisplayContentFlags contentFlags = 
GoogleDesktopDisplayContentFlags.GDD_CONTENT_ 

LAG_HAVE_DETAILS; 
helper.SetFlags(GoogleDesktopDisplayPluginFlags.G 

D_PLUGIN_FLAG_NONE, 
contentFlags); 

UpdateContentQ; 



il metodo Initialize esegue l'impostazione della 
modalità di visualizzazione del plugin come l'in- 
dicazione che deve poter mostrare i dettagli di 
ogni item. Inoltre esegue il metodo 
UpdateContent che si occupa di caricare gli ele- 
menti all'interno del plugin. Prima di eseguire 
l'implementazione del metodo, impostiamo i 
metodi richiesti dall'interfaccia IObjectWithSite 



dove viene passato un riferimento al cosiddetto 
sito del contenitore del plugin: 

IGoogleDesktopDisplaySite displaySite; 

public void SetSite(object site) 

{ 

displaySite = (IGoogleDesktopDisplaySite)site; 




if (displaySite != nuli) 



StartQ; 



else 



Stop(); 



> 



in questo modo, dopo aver dichiarato a livello 
di classe la variabile displaySite di tipo 
IGoogleDesktopDisplaySite, utilizziamo il 
metodo SetSite anche per avviare il polling del 
plugin che si occuperà di verificare ad inter- 
valli prestabiliti di 60 secondi, utilizzando un 
oggetto timer, la presenza di nuovi task nel 
database: 

private void Start() 

{ 

timer = new Timer(); 

timer.Tick += new EventHandler(OnTick); 

timer.Interval = 60000; 

timer. StartQ; 

} 

il metodo OnTick, richiamato dall'evento Tick 
dell'oggetto timer, esegue una chiamata al 
metodo UpdateContent, il vero fulcro del plu- 
gin. In esso, infatti, viene effettuata l'interro- 
gazione del database ed estratti i task da 
visualizzare. Il metodo utilizza l'oggetto Task 



PERSISTENZA DELLO STATO DEL PLUGIN 



IPersistStream permette ad un 
client di chiedere ad un oggetto 
di caricare i suoi dati persistenti 
e salvarli in uno stream. In 
genere quest'interfaccia è 
supportata da oggetti che hanno 
dati piuttosto semplici e che 
possono essere quindi 
memorizzati in un singolo 
stream. Quest'interfaccia ha solo 
cinque metodi: 

• Load chiede all'oggetto di 
caricare i suoi dati persistenti 
dallo stream di cui il client 
fornisce la posizione. 

• Save chiede all'oggetto di 
salvare i suoi dati persistenti 
nello stream indicato 



dall'oggetto. 

• IsDirty permette al client di 
sapere se i dati dell'oggetto sono 
stati modificati e se pertanto 
devono essere salvati prima di 
rilasciare l'oggetto. 

• GetSizeMax restituisce la 
massima dimensione dello 
stream nel caso in cui il client 
volesse chiamare subito il 
metodo Save. 

IPersistStreamlnit eredita tutti i 
metodi da IPersistStream, ma ha in 
aggiunta un ulteriore metodo, 
chiamato InitNew, con il quale il 
client fa sapere all'oggetto che sta 
per essere inizializzato per la prima 
volta. 
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Contentltem come contenitore dei vari task 
recuperati: 

void OnTick(object sender, EventArgs e) 

{ 

UpdateContentQ; 



void UpdateContentQ 



{ 



// qui utilizzo un dataset tipizzato 

// ed un TableAdapter tipizzato 

// per recuperare le informazioni dal database 

Archivio. MyData myData = new Archivio. MyData(); 
Archivio. MyDataTableAdapters.TasksTableAdapter 
adapter = 
new 

TaskPlugin. Archivio. MyDataTableAdapters.TasksTableA 

dapterQ; 



adapter. Fill(myData.Tasks); 



// qui imposto un flag comune a tutti 



GoogleDesktopContentltemDisplayOptions 

Analizziamo le diverse impostazioni possibili per il comportamento che ogni 
singolo Contentltem può avere con la sidebar di Google Desktop: 


GDD_ITEM_ 
DISPLAY_IN_SIDEBAR 


Consente di visualizzare un sin- 
golo Contentltem nella sidebar 


GDD_ITEM_DISPLAY_ 
IN_SIDEBAR_IF_VISIBLE 


Consente di visualizzare un sin- 
golo Contentltem nella sidebar se 
questa è visibile 


GDD_ITEM_DISPLAY_ 
AS_NOTIFICATION 


Consente di visualizzare una 
notifica nel momento in cui viene 
aggiunto il Contentltem 


GDD_ITEM_DISPLAY_AS_ 
NOTIFICATION_IF_SIDEBAR_HIDDEN 


Consente di visualizzare una 
notifica nel momento in cui viene 
aggiunto il Contentltem se la 
sidebar è nascosta 



GoogleDesktopDisplayContentltemLayout 

Google Desktop Display permette di utilizzare diverse modalità di layout 
per i singoli Contentltem. In questa tabella riassumiamo le varie possi- 
bilità consentite: 


GDD_CONTENT_ITEM_ 
LAYOUT_NOWRAP_ITEMS 


Visualizza una lista normale in cui ogni 
Contentltem occupa esclusivamente una 
singola riga 


GDD_CONTENT_ITEM_ 
LAYOUT_NEWS 


Ogni singolo Contentltem occupa due righe 
composte da un'intestazione e dalla data di 
creazione dello stesso 


GDD_CONTENT_ITEM_ 
LAYOUT_EMAIL 


Vengono visualizzate un'intestazione, il sor- 
gente del Contentltem e due righe di abstract 



// i Contentltem che consente di 

// visualizzare un'icona di fianco ad ogni item 

GoogleDesktopDisplayContentltemFlags itemFlags = 

GoogleDesktopDisplayContentItemFlags.GDD_CONT 

NT_ITEM_FLAG_LEFT_ICON; 

// rimuovo tutti gli item visualizzati 

this.RemoveAIIContentltemsO; 

foreach (Archivio. MyData. TasksRow row in 

myData.Tasks.Rows) 
i 

// imposto le variabili relative ad 
// ogni singolo Contentltem 

String heading = row.title + " " + 

row. date. ToString("dd/MM/yyyy HH:mm"); 



String source = "MyTaskList"; 



String snippet = row.description; 



// inizializzo l'oggetto corrente 



TaskContentltem curltem = new TaskContentltemQ; 



// imposto le proprietà del Contentltem corrente 



curltem. heading = heading; 



curltem. tooltip = heading; 



curltem. source = source; 



curltem. snippet = snippet; 



curltem. flags = itemFlags; 



curltem. image = contentlconl; 



// imposto il layout del Contentltem 
curltem. layout = 

GoogleDesktopDisplayContentIteml_ayout.GDD_CONT 
ENT_ITEM_LAYOUT_EMAIL; 

// Visualizzo l'item nella sidebar e, opzionalmente, 
// nella notifier window se la sidebar è nascosta 
GoogleDesktopContentltemDisplayOptions options = 
GoogleDesktopContentItemDisplayOptions.GDD_ITE 

_DISPLAY_IN_SIDEBAR | 

GoogleDesktopContentItemDisplayOptions.GDD_ITE 
_DISPLAY_AS_NOTIFICATION_IF_SIDEBAR_HIDDEN; 



// aggiungo il Contentltem creato 
this.AddContentItem(curItem, options); 



> 



} 



il codice visualizzato recupera i dati dal data- 
base ed esegue un ciclo tra i record trovati. 
Per ogni record viene creata un'istanza del- 
l'oggetto TaskContentltem che si occupa di 
visualizzare il contenuto impostato sulla base 
del layout impostato. 
Vengono inoltre impostate le opzioni che con- 
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sentono alFitem di essere visualizzato nella 
sidebar e nella notification area se la sidebar è 
nascosta. Il codice completo, compreso il 
database e l'accesso al database, è presente 
sul CD allegato alla rivista. 



IL CONTENT ITEM 

Ogni plugin è costituito da almeno un content 
item che si occupa di visualizzare i dati relativi ad 
un singolo elemento. Nel nostro caso, infatti, il 
content item visualizzerà ognuno dei task pre- 
senti nel database mostrando all'interno del 
plugin un breve elenco degli stessi. Aggiungiamo 
al progetto una nuova classe e la chiamiamo 
TaskContentItem.es. Inseriamo il riferimento al 
namespace GoogleDesktopDisplayLib, ereditia- 
mo dalla classe GoogleDesktopDisplayContent 
ItemHelperClass ed infine implementiamo l'in- 
terfaccia IGoogleDesktopDisplayContentltem 
Handler. Ereditando dalla classe helper possia- 
mo usufruire di molte delle caratteristiche già 
implementate come, ad esempio, i layout stan- 
dard. Per questo motivo implementiamo solo i 
metodi richiesti dall'interfaccia IGoogleDesktop 
Display ContentltemHandler: 

public interface 

IGoogleDesktopDisplayContentltemHandler 

{ 

void DrawItem(GoogleDesktopDisplayTarget target, 

int de, ref tagRECT bounds); 
int GetHeight(GoogleDesktopDisplayTarget 

display_target, int de, int width); 
void 

GetIsTooltipRequired(GoogleDesktopDisplayTarget 
target, int de, ref tagRECT bounds, out bool 

is_required); 
bool OnDetailsView(out string title, out 

GoogleDesktopDisplayDetailsViewFlags flags, out 
object details_control); 
bool OnRemoveltemO; 
void OpenItem(); 
voidProcessDetailsViewFeedback(GoogleDesktopDisp 

ayDetailsViewFlags flags); 
void ToggleItemPinnedState(); 
} 

Come detto, tutto il lavoro di visualizzazione del 
contenuto viene svolto dalla classe base 
GoogleDesktopDisplayContentltemHelperClass 
che si occupa, appunto, di elaborare le imposta- 
zioni da noi date nel metodo UpdateContent 
della classe TaskPlugin per costruire il layout, in 
riferimento all'impostazione scelta settando la 
proprietà layout. Se, opzionalmente, il nostro 
Contentltem deve poter visualizzare un dettaglio 



in riferimento ad una singola selezione, allora 
dobbiamo implementare il metodo OnDetails 
View che si occupa di gestire l'evento click asso- 
ciato alla visualizzazione del dettaglio: 

public new bool OnDetailsView(out string title, 
out GoogleDesktopDisplayDetailsViewFlags flags, 
out object detailsControl) 

i 

TaskDetailsView details = new TaskDetailsViewQ; 




details.Description = snippet; 



title = heading; 



flags = 
GoogleDesktopDisplayDetailsViewFlags.GDD_DETAILS 

_VIEW_FLAG_NONE; 

detailsControl = details; 
return false; 



> 



il metodo crea semplicemente un'istanza del 
controllo TaskDetailsView, uno user control che 
si occupa di fornire un'interfaccia personalizzata 
per la visualizzazione dei dettagli. Parliamo di 
interfaccia personalizzata perché è anche possi- 



Description 



I I Task eseguito 



Salva 



Fig. 2: La form per il gadget 



GoogleDesktopDisplayContentltemFlags 

Flags che inidicano come un particolare Contentltem dovrebbe essere 
visualizzato: 


GDD_CONTENT_ 
ITEM_FLAG_NONE 


Nessun comportamento 


GDD_CONTENT_ 
ITEM_FLAG_STATIC 


Imposta il Contentltem come non 
cliccabile 


GDD_CONTENT_ 
ITEM_FLAG_HIGHLIGHTED 


Evidenzia il Contentltem 


GDD_CONTENT_ 
ITEM_FLAG_PINNED 


Blocca il Contentltem 


GDD_CONTENT_ITEM_ 
FLAG_TIME_ABSOLUTE 


Visualizza il datetime del Contentltem 
come datetime assoluto 


GDD_CONTENT_ITEM_ 
FLAG_NEGATIVE_FEEDBACK 


Consente agli utenti di fare commenti 
negative sul Contentltem 


GDD_CONTENT_ITEM_ 
FLAG_LEFT_ICON 


Permette di visualizzare una icona sul lato 
sinistro del Contentltem 


GDD_CONTENT_ITEM_ 
FLAG_NO_REMOVE 


Non è possibile rimuovere il Contentltem 
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bile utilizzare le funzionalità standard ed il layout 
standard di Google Sidebar semplicemente 
istanziando la classe GoogleDesktop Display 
DetailsViewHelper. La visualizzazione a design- 
time del nostro controllo sarà simile a quella in 
figura 2 



COMPILAZIONE 
ED INSTALLAZIONE 
DEL PLUGMI 

La Google Sidebar interagisce con oggetti di 
tipo COM, perciò dobbiamo impostare il pro- 
getto per esporre il nostro plugin come ogget- 
to COM. Facendo click con il tasto destro sul 
progetto, apriamo le proprietà e ci posizionia- 
mo nella prima scheda Application. Qui clic- 
chiamo sul tasto Assembly Information, sele- 
zioniamo Make Assembly COM-Visible e con- 
fermiamo per rendere visibile il nostro assem- 
bly verso le applicazioni COM. Ora posizio- 
niamoci nella scheda Build e verifichiamo che 
il checkbox Register for COM Interop sia sele- 
zionato. In questo modo consentiamo a Visual 
Studio .NET di eseguire la registrazione del- 
l'assembly come oggetto COM, utilizzando il 
tool regasm.exe. Dopo aver correttamente 
eseguito queste impostazioni, è necessario 
installare il plugin per la visualizzazione nella 
Google Sidebar. Per far questo apriamo il file 
TaskPlugin.es e nella classe TaskPlugin inse- 
riamo i metodi RegisterFunction e Unregister 
Function che, decorati rispettivamente con 



gli attributi ComRegisterFunction Attribute e 
ComUnregisterFunctionAttribute, vengono 
richiamati al momento della registrazione 
con regasm.exe. Il codice completo dei due 
metodi è riportato sul CD allegato alla rivista. 
Provando a compilare il progetto dovrebbe 
comparirci un messaggio simile a quello 
visualizzato in figura 3 - 



Installazione gadget Google 



a 



Conferma che desideri installare: 

ioProgramnno - TaskPlugin - (ioProgramnno - TaskPlugin) 



No 



Fig. 3: La finestra che chiede conferma per l'indicazio- 
ne 

Ora il controllo è stato installato nella google 
sidebar e possiamo visualizzare il risultato 
così come riportato in figura 4 



fo Pro grammo - Task Plugin w X 

007/06/2006 12.00 -Appuntamento 

ioProgrammo 

Pranzo con il dott. Rossi 

fl 06/06/2006 10.00 -Acquistare 

ioProgrammo 

Ordinare il materiale di cancelleria mancante 


Aggi 

007/06/2006 
ioProgrammo 
Pranzo con il do 

006/06/2006 
ioProgrammo 
Ordinare il mate 
mancante 








1 


Thp FnH nf thp 



Fig. 4: Il nostro plugin in azione 



UNA PROPERTY WIIUDOW PER IL PLUGIN 



Google Desktop Display 
fornisce anche le API per la 
realizzazione di una pagina di 
proprietà della nostra sidebar. 
Per farlo seguiamo pochi 
semplici passi: 

1. Aggiungiamo al nostro 
progetto un nuovo form e lo 
chiamiamo PropertyForm 

2. Oltre al codice per ereditare 
dalla classe base Form, 
aggiungiamo anche 
l'implementazione 
dell'interfaccia COM 
IPropertyPage presente nel file 
imports.es 

3. Tra i metodi dell'interfaccia 
IPropertyPage utilizziamo 
l'implementazione del metodo 
ApplyO per salvare le 
impostazioni del nostro plugin. 
L'implementazione dei metodi 



è presente nel codice sul CD 
allegato alla rivista 

4. Progettiamo il form utilizzando 
il designer di Visual Studio 
.NET, come in figura - 
PropertyPage 

5. Apriamo il sorgente del nostro 
plugin TaskPlugin.es 

6. Aggiungiamo alla classe 
l'interfaccia 

ISpecifyPropertyPages costituita da 

un solo metodo GetPages: 
public void GetPages(ref 
CAUUID pages) 

{ 

Guid[] g = new Guid[l]; 
g[0] = 

typeof(PropertyPage).GUID; 
pages. SetPages(g); 



CONCLUSIONI 

Nell'articolo abbiamo visto come è possibile 
creare un plugin per Google Desktop, utiliz- 
zando TSDK e gli oggetti COM esposti, anche 
in C# con Visual Studio .NET. Seguendo alcuni 
passaggi abbiamo dapprima creato il plugin, 
poi il suo Contentltem ed infine il 
DisplayDetails che visualizza il singolo detta- 
glio all'interno di un comune UserControl. 
Anche se non è possibile sfruttare tutte le 
caratteristiche dell'ambiente managed, pos- 
siamo utilizzare il designer di Visual Studio 
.NET per progettare il nostro controllo in 
maniera visuale, la progettazione non è certa- 
mente delle più semplici, tuttavia una volta 
assimilati i concetti di base è possibile ottene- 
re risultati sorprendenti. D'altra parte veicola- 
re una propria applicazione attraverso un 
container come Google Desktop Search, è 
indice di sicuro successo. 

Fabio Cozzolino 
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ALLA SCOPERTA DEL 
PATTERN OBSERVER 

I PATTERN SONO "SOLUZIONI" UNIVERSALI A PROBLEMI COMUNI. IN QUESTO NUMERO 
AFFRONTIAMO IL CASO IN CUI UN OGGETTO DEVE COMUNICARE IL SUO STATO AD 
ALTRI. COME FARLO IN MODO DA GARANTIRE UN CODICE FACILMENTE ESPANDIBILE? 




jn 




■jj.i.wmiw.imfl 

| Basi di C++ 



Un qualunque 
compilatore C++ 



000 



Tempo di realizzazione 



Nei vari settori della tecnologia si affermano, 
col passare del tempo e con l'accumularsi 
dell'esperienza, "tecniche" di lavoro. 
Queste tecniche sono un sunto delle "esperienze sul 
campo" e si affiancano alla conoscenza teorica che 
ogni persona può avere nel proprio campo di com- 
petenza. Ad esempio è molto probabile che un neo- 
laureato in medicina abbia concetti teorici più "fre- 
schi" rispetto a un medico con 10 anni di esperien- 
za, tuttavia credo chiunque preferirebbe farsi curare 
da quest'ultimo. Il settore della programmazione 
non sfugge a questo principio e, anzi, ne riesce a for- 
malizzare i metodi. Questo consente ai volenterosi, 
di apprendere rapidamente concetti che altrimenti 
richiederebbero anni di esperienza per essere assi- 
milati. Quante volte ci è capitato di potere venire a 
capo di problemi apparentemente molto diversi tra 
loro, attraverso la medesima soluzione? Per chi scri- 
ve codice tutti i giorni questa è una evenienza abba- 
stanza frequente. Consci di questo fatto un gruppo 
di programmatori professionisti e studiosi del setto- 
re ha deciso di pubblicare, nel 1995, un libro che è 
presto diventato un riferimento per molti. Si tratta di 
"Design Patterns: Elements of Reusable Object- 
Oriented Software" e gli autori sono la cosiddetta 
"Gang of Four", i "quattro amici" che sono diventati 
per molti una sorta di "guida spirituale" in ambito di 
programmazione (si tratta di Gamma, Helm, 
Johnson e Vlissides). 



PROGRAMMARE 
CON I PATTERN 

Che cosa sono i pattern? E in che modo possono 
aiutarci a scrivere codice migliore? I pattern sono 
sostanzialmente delle soluzioni standard a delle 
problematiche frequenti in campo software. 
Queste soluzioni sono inserite all'interno di un 
contesto nel quale viene spiegata la problematica, 
viene spiegata la soluzione al problema e come ci si 
è arrivati, e viene fornito un esempio pratico di 
applicazione della soluzione. L'insieme di questi 



elementi costituisce quindi un "percorso" che il 
programmatore può seguire per giungere a una 
soluzione che sia garanzia di affidabilità, in quanto 
applicata (e testata) più volte in altri ambiti. 
I pattern della Gang of Four si basano pesantemen- 
te sulla programmazione orientata agli oggetti 
(OOP) e mirano a migliorare la qualità del codice 
agendo su caratteristiche legate ad essa. Ad esem- 
pio mirano ad aumentare la riusabilità del codice, 
ad aumentare il livello di incapsulamento delle 
informazioni di un oggetto e a diminuire il livello di 
coesione tra oggetti di classi differenti. 
Questo modo di operare porta alla costituzione di 
una serie di "mattoncini" di codice riutilizzabili 
nelle situazioni più diverse, operando solamente 
un minimo (o anche nullo) riadattamento. 
È possibile leggere un libro sui pattern (ne esistono 
diversi) utilizzandolo come una sorta di "catalogo 
delle soluzioni". Ogni pattern indirizza una proble- 
matica ben distinta e ciascun pattern è più o meno 
marcatamente utilizzabile in modo separato da 
qualunque altro. Descriveremo di seguito nell'arti- 
colo il pattern chiamato "Observer" che è di sicuro 
uno dei più utilizzati e più utili quando si ha a che 
fare con la sincronizzazione tra due o più oggetti in 
una applicazione. 



IL PATTERN OBSERVER 

Abbiamo detto che ciascun pattern indirizza 
una problematica ben precisa e la soluzione a 
questa problematica è ottenuta per gradi. 
Analizziamo ad esempio la seguente situazione: 

• abbiamo una applicazione dove diversi 
oggetti devono mantenere una informazio- 
ne aggiornata sullo stato di altri oggetti; 

• alcuni oggetti producono dei dati, altri 
devono essere informati sui dati prodotti in 
maniera tale da elaborarli. 

Un caso concreto potrebbe essere ad esempio quel- 
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lo di un software che equipaggia una bici da camera 
elettronica. Gli oggetti Cardio e Bike producono dati 
sul battito cardiaco di chi pedala e dati sull'utilizzo 
della bicicletta, come ad esempio il numero di peda- 
late al minuto. L'oggetto CalcolaCalorie ha bisogno 
di essere informato sui dati prodotti per elaborare il 
consumo medio di calorie da parte dell'atleta. 
Dal punto di vista della programmazione il 
problema consiste nel fare sì che un oggetto 
(ContaCalorié) possa essere informato sul cam- 
biamento di stato di un altro oggetto (Cardio o 
Bike). Cardio e Bike sono i soggetti (Subject) del- 
l'osservazione, che viene compiuta da 
ContaCalorié, che è l'osservatore (Observer). 
Come implementare la notifica del cambia- 
mento di stato da parte dei due produttori? 
Una possibile soluzione potrebbe essere la 
seguente: 

class ContaCalorié 

S 

public: 



void ImpostaCardioFrequenza( /* 



*/); 



void ImpostaPedalate( /* ... */ ); 



/* Altre funzioni qui ... /* 



(o i suoi observer), chiamando le relative fun- 
zioni. Ad esempio: 



m_ 


.riferimento. 


_contacalorie 
>ImpostaCardioFrequenza( /* ... 


*/); 




m_ 


.riferimento. 


_contacalorie- 


>ImpostaPedalate( / 


4= 

*/); 



Questa è una possibile soluzione del problema. Nel 
prossimo paragrafo spieghiamo perché sia una delle 
peggiori soluzioni adottabili. 




Subject 



Attach(Obs erver) 
D etach(Ob s erver) 
NotifyO 



-**- 



for ali o in observers{ 

o->UpdateO 

} 



UpdateQ 



Concrete Subject 



GetState0- 
SetStateO 



subjectState 



Concrete Qb server 
UpdateQ 



| return Subì e ctState 

I 



r 

| observerState 



_i ObserverState 
I = subject->GetStateQ 



Fig. 1: GUI dell'applicazione di esempio vista dal Flow Designer 



class Cardio 



{ 



public: 



void ImpostaRiferimento(const 

ContaCalorié*); 



/* Altri metodi pubblici */ 



private: 



ContaCalorié* m_riferimento_contacalorie; 



}; 



class Bike 



{ 



public: 



void ImpostaRiferimento(const 

ContaCalorié*); 



/* Altri metodi pubblici */ 



private: 



ContaCalorié* m_riferimento_contacalorie; 



>; 



In questo codice il meccanismo di funziona- 
mento prevede che ogni subject mantenga un 
riferimento al suo observer. Il riferimento 
all' observer deve essere impostato nei subject 
dall'esterno tramite la funzione Imposta 
Riferimento ()• Questa funzione valorizza il 
campo privato m_riferimento_contacalorie. Ogni 
qual volta lo stato del subject cambia, questi 
si prende carico di informare il suo observer 



cosa ce che moni VA 

Il codice appena visto indubbiamente ha il pregio di 
essere funzionante. Tuttavia per chi si prefigge di 
scrivere codice di qualità, il funzionamento di un 
software è il punto di partenza, non il traguardo (in 
altre parole: "almeno deve funzionare!"). 
Perché questa soluzione ci fa tanto, tanto storcere il 
naso? La risposta è: perché è monolitica. Dovessimo 
cambiare idea su una sola parte del funzionamento 
globale del programma, dovremmo riscrivere da 
capo praticamente tutto. 

Le classi Cardio e Bike presentano un'alta coesione 
con l'oggetto ContaCalorié. Probabilmente 
ContaCalorié non avrebbe nemmeno senso di esi- 
stere se non in accoppiata con i suoi subject. L'alta 
coesione fra classi è sempre una cosa che va evitata 
poiché per piccole modifiche costringe a riscrivere 
(e quindi buttare via) porzioni di codice molto gran- 
di. Un altro problema abbastanza grave che risiede 
in questo codice è di ordine strettamente concettua- 
le. Perché devono essere i soggetti dell'osservazione 
a dovere inviare informazioni agli oggetti che desi- 
derano osservarli? 

Come si fa a sapere se in futuro ci saranno o meno 
altri tipi di osservatori? In tal caso è evidente che si 
dovrà riscrivere molto codice, perdendo tempo e 
introducendo possibili bug. 
Supponiamo ad esempio di volere aggiungere una 
nuova classe DistanzaPercorsa come elaboratore dei 
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dati forniti da Bike e Cardio. Dovremmo innanzitut- 
to scrivere una classe con una struttura pressoché 
identica a ContaCalorie: 



class DistanzaPercorsa 


{ 


public: 




void ImpostaCardioFrequenza( /* . 


■ */); 


void ImpostaPedalate( /*...*/); 


/* Altre funzioni qui ... /* 


}; 



questo viene meno al principio di "incapsulare le 
informazioni che cambiano" e si traduce nella proli- 
ferazione di tanto codice che si ripete identico in 
diversi punti. 

Successivamente dovremmo per forza modificare le 
classi subject in modo che esse possano contenere il 
riferimento al nuovo observer, e in modo tale che, 
ogni qual volta il loro stato cambia, anche questo 
nuovo observer ne sia informato: 

m_riferimento_distanza->ImpostaCardioFrequenza( 

/* - */ ); 

m_riferimento_distanza->ImpostaPedalate(); 

Se pensiamo quindi al fatto che per aggiungere un 
semplice observer dobbiamo obbligatoriamente 
modificare il codice di tutti i subject cui esso è inte- 
ressato, capiamo bene come il numero delle modifi- 
che, col crescere degli observer, diventerebbe presto 
ingestibile. 

Il tutto senza contare la presenza di altre grosse limi- 
tazioni. Se ad esempio volessimo inserire più di un 
oggetto per ogni classe observer (ad esempio mette- 
re due oggetti Conta Calorie), semplicemente non 
potremmo farlo, in quanto ogni subject contiene un 
solo riferimento come attributo privato. Inserire 





W PICCOLA BIBLIOGRAFIA SUI PATTERN. 


Il libro che ha contribuito alla 


esempio segnaliamo: 


formalizzazione del concetto di 




"pattern" e che rappresenta il 


• "Design Patterns Java 


capostipite di questa letteratura è 


Workbook" (Steven John 


sicuramente quello citato nel corpo 


Metsker) 


dell'articolo e cioè: 


• "Pattern Hatching: Design 




Patterns Applied" (John 


• "Design Patterns: Elements of 


Vlissides) 


Reusable Object-Oriented 


• "Framework-based Software 


Software" (Gamma, Helm, 


Development in C++" (Gregory F. 


Johnson, Vlissides). 


Rogers) 




• "Patterns and Skeletons for 


Questo libro tuttavia, oltre a 


Parallel and Distributed 


definire dei pattern, definisce 


Computing" (F.A. Rabhi and S. 


anche una maniera standard per 


Gorlatch) 


formalizzare un pattern. Anche 


• "Striali Memory Software: 


grazie a questo fatto sono stati 


Patterns for Systems with 


scritti diversi altri libri sui pattern. 


Limited Memory" (James Noble & 


appi 


icati in ambiti differenti. Ad 


Charles Weir) 



riferimenti in un array contribuirebbe ulteriormen- 
te ad aumentare il numero di modifiche al codice in 
caso di cambiamenti anche piccolissimi. 
Insomma: soluzione scartata! 



UNA SOLUZIONE 
MIGLIORE 

Per ottenere qualcosa di qualitativamente migliore, 
che sia riutilizzabile senza troppi sforzi, dobbiamo 
necessariamente ripensare l'approccio intrapreso in 
precedenza. Innanzitutto va eliminata la dipenden- 
za del subject dal suo observer. L'oggetto osservato 
deve avere come unico compito quello di segnalare 
che il suo stato è cambiato. Non deve essere tuttavia 
obbligato a conoscere quale sia il suo observer (o 
quanti siano), né di quali dati l' observer abbia biso- 
gno. Sarà l' observer stesso, una volta ricevuta la 
notifica del fatto che "qualcosa è cambiato", a 
richiedere le informazioni di cui ha bisogno, invo- 
cando i metodi pubblici del subject. 
Questo meccanismo è mirato a realizzare il 
disaccoppiamento tra subject e observer. Per sle- 
gare inoltre il concetto astratto di subject e 
observer, dalle loro varie realizzazioni concrete 
(ad es. Cardio -subject, Contacalorie- observer) è 
opportuno utilizzare uno dei meccanismi propo- 
sti dai linguaggi basati sugli oggetti, e cioè l'ere- 
ditarietà. Quello che si fa è incapsulare il codice 
generico di un subject o di un observer in una 
classe base. 

Da questa classe deriveremo le nostre classi spe- 
cializzate, che forniranno le funzionalità di cui 
abbiamo bisogno, ma utilizzeranno il codice 
delle loro classi base per implementare il mecca- 
nismo di notifica e richiesta dello stato. 
Chiamando Subject e Observer le classi base, 
indichiamo genericamente con ConcreteSubject 
e ConcreteObserver le loro derivate. 
Sostituiremo in seguito queste realizzazioni con 
le classi previste nel nostro esempio. 



class Subject 


{ 


public: 


virtual void Attach(Observer*); 


virtual void Detach(Observer*); 


virtual void Notify(); 


/* Altri eventuali metodi qui ... */ 


}; 


class Observer 


{ 


public: 


virtual void Update(); 




/* Altri eventuali metodi qui ... */ 


}; 
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Il diagramma UML completo per il pattern Observer 
è mostrato in FIGURA. Il funzionamento è molto 
semplice: 

• l' Observer, per notificare al Subject di essere inte- 
ressato al suo stato, si connette ad esso tramite la 
funzione AttachQ (la funzione DetachQ esegue 
l'operazione inversa); 

• ogniqualvolta un Subject vuole notificare ai suoi 
Observer un suo cambiamento di stato chiama la 
funzione NotifyQ. Questa funzione richiama a 
sua volta la Update () per tutti gli Observer con- 
nessi; 

• il codice della funzione UpdateQ deve essere spe- 
cializzato nella classe che deriveremo da 
Observer. Per questo motivo dichiariamo tale 
funzione con la parola chiave "virtual". 

Nel corpo della UpdateQ tipicamente si inserisce il 
codice per richiedere al Subject le informazioni sul 
suo stato. Anche questo tipo di richiesta varia a 
seconda di come specializziamo le derivate di 
Subject. Vediamo come effettuare queste specializ- 
zazioni. 



virtual void Update(); 






/* Altri eventuali metodi qui . 


■ */ 


}; 



Come si vede la specializzazione consiste nell'inse- 
rire i metodi specifici per gli oggetti che ci interessa- 
no. In particolare abbiamo fornito l'interfaccia di 
Cardio e Bike delle relative funzioni GetX(), funzioni 
che nella nostra prima implementazione- di- scarsa- 
qualità erano poste, in maniera innaturale, all'inter- 
no dell'oggetto che osservava, anziché di quello che 
era osservato. 

Per quanto riguarda la funzione Update () una possi- 
bile struttura di codice potrebbe essere la seguente: 



// supponiamo di avere memorizzato i riferimenti ai 



subject 



// in apposite variabili membro di ContaCalorie 



void ContaCalorie: :Update() 



{ 



int pedalate = m_riferimento_bike->GetPedalate(); 




this->ElaboraPedalate(pedalate); 



LA SPECIALIZZAZIONE 

La struttura di classi appena presentata deve essere 
utilizzata come base per derivare classi che modelle- 
ranno il comportamento da noi voluto. Questo è un 
grande pregio poiché il codice scritto per Observer e 
Subject resterà lo stesso anche quando in futuro vor- 
remo utilizzare il pattern Observer per una applica- 
zione completamente differente. È questo che si 
intende per riusabilità del codice. 
Le nuove classi Cardio, Bike e ContaCalorie sono 
dichiarate come segue: 

class Cardio : public Subject 

{ 
public: 

int GetCardioFrequenza(); 

/* Altri eventuali metodi qui ... */ 



class Bike : public Subject 

J 

public: 

int GetPedalateQ; 



/* Altri eventuali metodi qui ... */ 



int frequenza = m_riferimento_cardio 

>GetCardioFrequenza(); 
this->ElaboraCardioFrequenza(frequenza); 



class ContaCalorie : public Observer 

J 

public: 



} 



CONCLUSIONI 

In una complessa applicazione orientata agli 
oggetti, molti di questi lavorano all'unisono per 
ottenere il comportamento desiderato. In questo 
contesto la gestione delle dipendenze tra gli stati di 
questi oggetti è un problema fondamentale. In 
questo articolo abbiamo mostrato come il pattern 
Observer possa essere utilizzato per mantenere la 
consistenza tra gli stati. Lo abbiamo fatto partendo 
da un caso concreto e mostrandole differenze tra 
una soluzione rabberciata e una di qualità. 
L'utilizzo dei pattern può rappresentare sicura- 
mente un miglioramento della qualità del codice 
che scriviamo. Tuttavia non dobbiamo considerar- 
lo come la "manna dal cielo" che risolve tutti i pro- 
blemi. Inoltre lo studio dei pattern, per quanto 
serva a dare un notevole balzo in avanti nell'espe- 
rienza del design delle applicazioni, non si sostitui- 
sce (né mai alcuna cosa potrà farlo) alla reale espe- 
rienza sul campo, per cui a volte è bene ascoltare il 
parere di qualche collega con magari qualche anno 
di esperienza in più e qualche libro sui pattern in 
meno sugli scaffali di casa. Insomma anche per 
usare correttamente i pattern c'è bisogno di espe- 
rienza! 

Alfredo Marroccelli 
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CREARE APPLICAZIONI 
J2ME CON NETBEANS 

LE APPLICAZIONI PER DISPOSITIVI MOBILI SU PIATTAFORMA J2 ME RAPPRESENTANO UNA 
PERCENTUALE ELEVATA FRA QUELLE SUL MERCATO. SCOPRIAMO COME CREARLE IN MODO 
FACILE E VELOCE ATTRAVERSO L'USO DEL MOBILITY PACK DI NETBEANS 




jn 




REQUISITI 



t Basi di J2 ME 



t Java 2 Standard Edition 
SDK 1.4 o superiore, 
Netbeans 5.0, 
Netbeans Mobility Pack 
5.0 



_J_J^J 



Tempo di realizzazione 



e 



Il mercato degli ambienti di sviluppo di sup- 
porto alla programmazione è in continua 
evoluzione. Sicuramente la tecnologia Java 
vanta il maggior numero di tool facenti parte di 
questa categoria. Tra gli strumenti maggiormen- 
te diffusi si possono citare Eclipse, Netbeans, 
JBuilder, JDeveloper e IntelliJ IDEA. Ciascun tool 
ha i propri punti di forza che lo caratterizzano e 
fanno sì che venga scelto come IDE di riferimen- 
to. Dopo l'introduzione della piattaforma J2ME 
per dispositivi mobili, tutti i gruppi di sviluppo 
IDE si sono messi a lavoro per supportare ed age- 
volare i programmatori nell'implementazione 
delle nuove applicazioni per questo tipo di tec- 
nologia. 

Alcuni produttori hanno scelto di integrare in 
modo inscindibile il supporto allo sviluppo di 
applicazioni mobili all' IDE stesso; altri, come 
Netbeans o Eclipse, hanno preferito creare 
moduli separati (add-on o plugin) per sopperire 
a tale mancanza. Nel panorama J2ME il Mobility 
Pack, un add-on del Netbeans IDE distribuito 
gratuitamente, risulta essere uno degli strumenti 
maggiormente utilizzati in quanto presenta delle 
caratteristiche innovative che permettono di svi- 
luppare applicazioni in modo fluido e veloce. Il 
componente più interessante, su cui ci sofferme- 
remo nel corso dell'articolo, è il Visual Mobile 
Designer che, così come il Matisse GUI Builder 
per la creazione di interfacce Swing, permette di 
creare e modificare in maniera visuale (via drag 
and drop) le componenti grafiche per applica- 
zioni costruite sullo strato MIDP 2.0. 



UN'APPLICAZIONE 
DI ESEMPIO 

In questo articolo, per meglio capire il funzio- 
namento e le potenzialità del Mobility Pack, 
implementeremo una semplice applicazione 
di conversione valuta, che chiameremo 
MobileExchange, che dovrà presentare i 



seguenti requisiti funzionali: 

1. screenshot di avvio con visualizzazione di 
un'immagine 

2. caricamento da file della lista valute con i 
rispettivi rapporti di cambio 

3. calcolo, da un importo in valuta x, del corri- 
spettivo in valuta y 

Il file contenente i rapporti di cambio non è 
altro che un semplice documento di testo 
contenente una lista di nomi di valute ed il 
rispettivo valore di cambio separati dal sim- 
bolo "=": 



# rapporti cambio aggiornati al 


30/05/06 


Euro=l 


Dollaro USA=0.7772 


Sterlina = 1.4629 


Yen = 0.6927 


Franco Svizzero = 0.6417 


Dollaro Canadese=0.7068 


Dollaro Australiano = 0.5921 


Pesos=0.0690 



Per separare la parte grafica da quella dati e 
rendere il codice più elegante concentreremo 
le parti di caricamento e calcolo dei valori di 
cambio nella classe it.ioprogrammo. Exchange 
RateManager. Per garantire la presenza di una 
sola istanza di questo tipo all'interno della 
KVM (Kilo Virtual Machine) implementeremo 
il pattern singleton, pertanto alla prima invo- 
cazione del metodo getlnstance() verrà ese- 
guito il seguente costruttore: 

/* Costruttore interno per l'implementazione 

del pattern singleton */ 
private ExchangeRateManager() { 

// carica tutte le linee del file di valute ... 
Vector values = 

this.loadElements("/res/ rates.txt", "\n"); 
int size = values. sizeQ; 
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this.currenciesTable = new Hashtable(size); 
String line; 

// ... popola la tabella di rapporti cambio 
for (int i = 0; i < size; i + + ) { 

line = (String)values.elementAt(i); 

int equallndex = Iine.index0f(" = "); 

// verifica il corretto inserimento della 

coppia <nome> = <valore> 

if (equallndex > 0) { 

this.currenciesTable. put(line.substring(0, 

equallndex), 



Double(Double.parseDouble(line.substring 
(equallndex+l)))); 
} 



} 



Per il calcolo dei valori di rapporto cambio 
esporremo il metodo getExchangeRate 
BetweenO che necessita degli identificativi 
della valuta di origine e di quella finale. 

public doublé getExchangeRateBetween (String 

curi, String cur2) { 
if (!currenciesTable.containsKey( curi) || 
!currenciesTable.containsKey( cur2) ) { 
return 0.0D; 

> 

doublé ammountl = ((Doublé 

)currenciesTable.get( curl)).doubleValue(); 
doublé ammount2 = ((Doublé 

)currenciesTable.get( cur2)).doubleValue(); 
return ammountl / ammount2; 



PRIMI PASSI CON 
IL VISUAL DESIGNER 

Adesso ci addentreremo nell'implementazio- 
ne della GUI dell'applicazione attraverso il 
componente chiave del Mobility Pack: il 
Visual Mobile Designer. Questo tool, che con- 
sente il disegno e lo sviluppo di MIDlet, si 
divide in tre macro aree: Flow Design, Screen 
Design e Source. Per la creazione di una 
nuova Visual MIDlet cliccare su File -> New 
File e selezionare il tipo Visual MIDlet nella 
categoria MIDP. La vista ottenuta selezionan- 
do la prospettiva Flow Design consente allo 
sviluppatore di aggiungere degli oggetti di 
tipo javax.microedition. lcdui. Screen e di spe- 
cificarne le connessioni tra gli stessi definen- 
do il flusso dell'applicazione. In Figura 1 è 
illustrato il flusso logico che descrive la GUI 
dell'applicazione di esempio: la griglia cen- 
trale delinea l'area di disegno mentre nella 
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Fig. 1: GUI dell'applicazione di esempio vista dal Flow Designer 

parte destra troviamo la palette contenente i 
componenti inseribili via drag and drop. 
L'azione successiva all'avvio dell'applicazio- 
ne, rappresentata dall'etichetta "Start Point", 
visualizza un oggetto SplashScreen che termi- 
na con la visualizzazione della Form di con- 
versione. Per chi ha già avuto a che fare con 



COME INIZIARE 



1. É indispensabile avere installato 
sul computer Java 2 Standard 
Edition 1.4 o superiore. É 
preferibile utilizzare l'ultima 
versione disponibile dal sito 
http://java.sun.com. 

2. Scaricare Netbeans IDE ed il 
Mobility Pack dalla sezione 
Downloads del sito 
http://www.netbeans.org. 
Installare prima l'ambiente di 
sviluppo e successivamente il 
Mobility Pack. Quest'ultimo 
integra al suo interno la versione 
2.2 del J2ME Wireless Toolkit. 

3. Decomprimere su filesystem il 
contenuto del file netbeans.zip, 
contenuto nel cd-rom allegato. 



in una directory a piacere . 

4. Una volta avviato l'I DE, cliccare 
su File -> Open Project e 
selezionare la cartella 
MobileExchange contenuta 
all'interno del file scompattato 
precedentemente. 

5. La Visual Midlet di esempio, 
preparata per questo articolo, è 
contenuta nella classe 
it.ioprogrammo.MobileExchang 
eMIDIet. Una volta aperta sarà 
possibile navigare tra le 
modalità Source, Screen Design 
e Flow Design che danno la 
possibilità di editare il 
progetto sotto diversi punti di 
vista. 



applicazioni J2ME il nome SplashScreen 
potrebbe suonare nuovo. Quest'ultimo, infat- 
ti, non è tra gli Screen standard messi a dispo- 
sizione dallo strato MIDP ma è un elemento 
aggiuntivo facente parte di un set di compo- 



*— F 
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Fig. 2: Definizione dello Screen per la schermata 
di conversione valuta 
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nenti grafici custom esposti dal Mobility Pack. 
Oltre a quello appena citato ne troviamo 
anche altri di grande utilità come tabelle o 
wait screen. 

Attraverso la vista dello Screen Designer è 
possibile definire in maniera più dettagliata i 
singoli elementi Screen realizzati nello step 
precedente. 

In Figura 2 è visualizzata la definizione del 
convertForm: nella parte sinistra troviamo 
una preview dello Screen in questione, al cen- 
tro l'elenco dei comandi associati ed a destra 
la palette contenente oggetti Command e 
Item. 

Come si può notare la struttura della form è 
abbastanza semplice ed è costruita utilizzan- 
do un TextField per l'inserimento del valore 
originale, due ChoiceGroup per la scelta delle 
valute iniziale e finale, uno Stringltem per la 
visualizzazione del risultato e due comandi. 
Per editare le caratteristiche (titolo, layout, 
ecc.) di ciascun elemento grafico aggiunto è 
necessario prima selezionarlo e poi aprire il 
dialog di Properties dal popup menu ottenuto 
cliccando sul tasto destro del mouse. 



INTEGRAZIONE 

DEL CODICE GENERATO 

Una volta completato il disegno dell'interfac- 
cia grafica dell'applicazione non rimane che 
integrarla con la parte logica. Per editare il 
codice generato dal Designer utilizzeremo la 
vista Source. 

Ovviamente, per non disallineare il codice 
generato dalle rappresentazioni di Screen e 
Flow Designer, non sarà possibile editare il 
codice integralmente. Di seguito vediamo 
come è stato introdotto il calcolo dell'opera- 
zione di conversione scatenata dall'azione 
legata al comando convert Command: 



public void co m ma ndAction (Command 

command, Displayable displayable) { 
// Insert global pre-action code nere 
if (displayable == convertForm) { 
if (command == exitCommandl) { 
// Insert pre-action code here 

exitMIDIetQ; 

// Insert post-action code here 



} else if (command 



convertCommand) { 



// Insert pre-action code here 



// Do nothing 



// Insert post-action code here 



String value 



this.valueField.getStringO; 



// controllo la presenza del valore 



doublé result = 0; 



if (value != nuli && value. Iength() > 

0) { 

doublé rate = 
ExchangeRateManager.getInstance(). 
getExchangeRateBetween( 
this.fromCurrencyChoice.getString 

(this.fromCurrencChoice.getSelectedlndexO), 
this.toCurrencyChoice.getString 

(this.toCurrencyChoie.getSelectedlndexQ)); 



/ 



result = Doublé. parseDouble(value) 



rate; 



} 



this. stringltem l.setText("" + result); 



} 



// Insert global post-action code here 



} 



Il codice in rosso evidenzia le parti che 
Netbeans ci vieta di modificare mentre le 
zone "libere" sono precedute da specifici 
commenti (es: // Insert post-action code 
here). 





1 PRINCIPALI CARATTERISTICHE 




w DI NETBEANS MOBILITY PACK 5.0 


• Basato su Netbeans IDE 




ridurre il problema di Device 


• Visual Mobile Designer con 




Fragmentation (compatibili con 


editing drag and drop 




Antenna e J2ME Polish) 


• Possibilità di editare il codice 


• 


J2ME Wireless Toolkit 2.2 


generato dal Visual Designer 




integrato 


• Aggiunta di nuovi componenti 


• 


Build system Ant based 


grafici custom 


• 


Possibilità di deploy via FTP, SCP 


• Offuscamento integrato, diviso 




e WebDAV 


in livelli, per proteggere la 


• 


Supporto per la localizzazione 


proprietà intellettuale ed 


• 


Possibilità di aggiungere 


ottimizzare la dimensione dei jar 




emulatori di terze parti 


generati 


• 


Supporto per Java ME Web 


• P 


reprocessor Directives per 




Services (JSR 172) 



PREPROCESSOR 
DIRECTIVES & 
OBFUSCATIOIM 

Tra i problemi che spesso gli sviluppatori 
J2ME si trovano ad affrontare ci sono quelli 
riguardanti il fenomeno di "device fragmenta- 
tion" e le eccessive dimensioni dell'applica- 
zione. Il primo aspetto è il risultato delle dif- 
ferenze implementative e della varietà di 
attributi che ciascun produttore apporta ai 
vari dispositivi provvisti di una KVM. Per 
minimizzare eventuali problemi di compati- 
bilità tra i vari dispositivi è spesso necessario 
creare specializzazioni "ad hoc" per una serie 
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di vendor o addirittura famiglie di dispositivi. 
Questo espediente, che si traduce nell'effort 
di mantenere più versioni dello stesso softwa- 
re, è facilitato dall'uso delle Project 
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Fig. 3: Configurazione dei livello di offuscamento 

Configurations e Preprocessor Directives 
messe a disposizione dal Mobility Pack. Il 
seguente metodo di esempio 

1 public String greetDevice () { 

2 H#ifNokia_40 

3 return "Welcome Nokia 40 Series"; 

4 ll#else 

5 return "Welcome. What's your name?"; 

6 ll#endif 

7 } 



CONCLUSIONI 

In un momento in cui lo sviluppo per disposi- 
tivi mobili rappresenta una percentuale molto 
elevata del mercato della programmazione, il 
Mobility Pack rappresenta una soluzione ad 
alto valore aggiunto, probabilmente Tunica in 
grado di contrastare la semplicità di sviluppo 
che si manifesta quando si sviluppa per il 
rivale "Pocket PC". Se J2ME vuole mantenere 
la leadership sul mercato dei device portatili 
deve affiancare alla già tradizionale flessibi- 
lità, anche strumenti di lavoro che consenta- 
no a noi programmatori di sviluppare appli- 
cazioni in modo rapido ed immediato. 
In questo articolo abbiamo dimostrato come 
costruire una semplice applicazione di con- 
versione valuta per dispositivi mobili in modo 
facile e veloce con Netbeans ed il Mobility 
Pack. Quest'ultimo rappresenta, al momento, 
lo strumento più avanzato per la creazione di 
applicazioni J2ME. Nei prossimi articoli intro- 
durremo il processo di creazione di applica- 
zioni CDC con componenti grafici avanzati. 
Lo scopo finale sarà quello, di mostrare da un 
lato come accelerare il processo di produzio- 
ne, dall'altro sviluppare applicazioni comple- 
te dotate di una grafica accattivante e di fun- 
zionalità avanzate. In tutto questo ci faremo 
aiutare di volta in volta dai vari strumenti evo- 
luti disponibili. 




contenente, sotto forma di commento in 
linea, le semplici direttive "if/else/endif", 
consentirà la creazione automatica di due 
distinte applicazioni: la prima, "assemblata" 
con l'invocazione return di riga 3, per disposi- 
tivi Nokia facenti parte della famiglia 40 e la 
seconda per tutti gli altri tipi di device. 
Un'altra limitazione da tener presente è rap- 
presentata dal "peso" dell'applicazione. Ogni 
dispositivo, ad eccezione di quelli di ultima 
generazione con possibilità di espansione di 
memoria, presentano delle restrizioni specifi- 
cate dalla proprietà MaxJarSize che definisce 
la dimensione massima per un'applicazione 
J2ME. Per "snellire" il codice Netbeans ci offre 
la possibilità di offuscare il sorgente a più 
livelli, il tutto configuarabile dalle proprietà 
del progetto. Ovviamente questa possibilità 
risulta molto comoda, sia per ridurre il peso 
che per aumentare la sicurezza dell'applica- 
zione. Per maggiori informazioni inerenti le 
caratteristiche e le limitazioni di ogni singolo 
dispositivo è possibile consultare il sito 
http://www.j2mepolish.org/devices-over- 
view.html, all'interno del quale troverete 
informazioni dettagliate su ogni singolo 
dispositivo. 



Fabrizio Fortino 



COSA CI PROSPETTA IL FUTURO? 



Secondo alcuni studi presentati 
durante l'ultima Java One 
Conference, tenutasi a San 
Francisco, oltre il 60% dei telefoni 
cellulari in circolazione sono 
equipaggiati di piattaforma Java. 
La grande maggioranza di questi 
dispositivi, a causa di limitazioni 
hardware, implementano lo strato 
CLDC (Connected Limited Device 
Configuration) che, come si intuisce 
dalla stessa sigla, mette a 
disposizione del programmatore un 
set di librerie abbastanza limitato. 
Con l'evoluzione dei dispositivi 
mobili (con memoria di almeno 
2MB) sarà possibile implementare 
applicazioni basate su CDC 
(Connected Device Configuration), 
che presentano una API più ricca e 
permettono l'utilizzo di 
componenti grafici avanzati. Visto 
che il mercato della telefonia 
mobile è in continuo fermento, la 
comunità di Netbeans ha ritenuto 
saggio non farsi trovare spiazzata 



ed ha già "sfornato" il nuovo 
Mobility Pack 5 for CDC, disponibile 
per OS Windows al sito 
http://www.netbeans.info/downloa 
ds/do wn I oad-cdc. h t m I 
Sempre durante un intervento alla 
Java Conference, James Gosling, 
ospite dell'appuntamento 
milanese, "padre" di Java e attuale 
Vice President di Sun Microsystems, 
ha affermato che i telefoni cellulari 
saranno i desktop del futuro. 
Questa decisa affermazione è stata 
accompagnata dall'ingresso nel 
mercato del primo dispositivo 
mobile dotato di un sistema 
operativo "aperto" realizzato in 
Java: Savaje 

(http://www.savaje.com). 
Lo smartphone in questione è il 
Jasper S20, distribuito dalla casa 
americana GSPDA 
(http://www.gspda.com), con cui 
sarà possibile sfruttare le 
potenzialità dei componenti Swing 
e Java2D. 
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MENO CODICE CON 
IL NAMESPACE MY 

LO SPAZIO DEI NOMI "MY" PERMETTE DI UTILIZZARE IN MODO SEMPLICE, MOLTE CLASSI 
DEL .NET FRAMEWORK CONSENTENDO UN'INTERAZIONE RAPIDA CON IL COMPUTER, 
L'APPLICAZIONE, LE IMPOSTAZIONI E LE RISORSE, RENDENDO PIÙ LEGGERO IL CODICE 
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Una delle più interessanti nuove caratteri- 
stiche dì Microsoft Visual Basic 2005 è 
l'introduzione del namespace My. Il 
namespace My contiene un insieme di oggetti 
che forniscono percorsi semplificati a molte aree 
del .NET Framework, riducendo il numero di 
righe di codice che è necessario scrivere in 
maniera efficiente ed affidabile. Il namespace My 
espone alcuni oggetti che vengono creati dina- 
micamente ogni volta che si aggiungono caratte- 
ristiche al progetto corrente. Gli oggetti del 
namespace My sono accessibili in modalità a 
tipizzazione forte, con l'aiuto di IntelliSense eli- 
minando gli errori a runtime provocati da errori 
di digitazione. I tre oggetti My principali sono: 
My. Application, My.Computer e My. User. 
Questi oggetti possono essere utilizzati per acce- 
dere alle informazioni rispettivamente sull'ap- 
plicazione corrente, sul computer sul quale è 
installata l'applicazione o sull'utente corrente 
dell'applicazione. In questo articolo ci occupere- 
mo in dettaglio dell'oggetto My.Computer 



UNO SGUARDO 
DI INSIEME 

Descriviamo brevemente gli oggetti contenuti 
nel namespace My 

• My.Application mette a disposizione informa- 
zioni sull'applicazione corrente, come il per- 
corso, la versione, la nazionalità e la modalità 
e autenticazione dell'utente. 

• My.Computer mette a disposizione molti 
oggetti figli che consentono di raccogliere 
informazioni e utilizzare le caratteristiche 
principali del computer, tra cui filesystem, i 
sottosistemi audio e video, la memoria, la 
tastiera, il mouse, la rete, porte seriali, la stam- 
pante d altro. 

• My.Forms è subito disponibile e definisce un 



metodo factory per ciascuna classe form defi- 
nita nel progetto corrente. Permette di refe- 
renziare l'istanza di default di un form senza 
dover creare esplicitamente un oggetto della 
classe form. 

• My.Resources contiene un oggetto per ciascu- 
na risorsa definita nel progetto corrente. Se, 
ad esempio, aggiungiamo al progetto una bit- 
map denominata Master, sarà possibile acce- 
dervi mediante My.Resources. Master. 

• My.Settings mette a disposizione una pro- 
prietà per ciascuna impostazione di configu- 
razione determinata nelle impostazioni cor- 
renti; a livello di applicazione o per utente. 
Una risorsa a livello di applicazione può esse- 
re condivisa da tutti gli utenti, una risorsa a 
livello di utente può essere modificata dall'u- 
tente corrente. 

• My. User permette di accedere alle informazio- 
ni sull'utente correntemente collegato e per- 
mette di implementare un meccanismo di 
autenticazione custom. 

• My. WebServices mette a disposizione una pro- 
prietà per ciascun Web service a cui il proget- 
to corrente ha un riferimento. 
My.WebServices consente di individuare la 
classe in maniera automatica e fornisce un'i- 



My 



MyXomputer 
My,Computer.Audlo 
My,Computer.Cllpboard 
My.Computer. Clock 



My.Application 
My, Application, Lag 



My.Forms 
My.Log 



My.Application. Info 



My.Response 



M y. Ce>m pu te r. Fi leSystem 

My.Computer. Info 
My.Computer. Key board 
My.Computer. Mouse 
My.Ccmpu;er, Network 
My.CcmputEr.PDrts 
My.Camputer.Registry 



My.Recuest 
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My.Settings 



My.User 



My.WebServices 



Fig. 1: La gerarchia delle classi del namespace My 
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stanza della classe proxy del servizio Web 
richiesta. 



su 



L'OGGETTO 
MY.COMPUTER 

L'oggetto My.Computer è un oggetto traboccante 
di funzionalità e fornisce le proprietà per la 
gestione dei componenti del computer come 
audio, orologio, tastiera, file system, memoria, 
mouse, porte seriali, la Clipboard, e il registro di 
sistema. 

Gli oggetti messi a disposizione da My.Computer 
sono: 

o Audio. L'oggetto My.Computer. Audio consente 
di accedere al sistema audio del computer e for- 
nisce inoltre i metodi per la riproduzione dei file 
.wav. 

• Clipboard. L'Oggetto My.Computer. 
Clipboard mette a disposizione i metodi per la 
modifica degli Appunti. 

o Clock. L'oggetto My.Computer. Clock mette a 
disposizione le proprietà per accedere all'ora 
locale corrente e al tempo universale coordi- 
nato (UTC), equivalente all'ora di Greenwich, 
dall'orologio di sistema. 

• FileSy sterri. L'oggetto 
My.Computer.FileSystem mette a disposizio- 
ne proprietà e metodi per l'utilizzo delle 
unità, dei file e delle directory. 

• Info. L'oggetto My.Computer. Info mette a 
disposizione le proprietà che permettono di 
ottenere informazioni sulla memoria, sul 
nome e sul sistema operativo del computer. 

• Keyboard. L'oggetto My.Computer. 
Keyboard mette a disposizione le proprietà 
per accedere allo stato corrente della tastiera, 
ad esempio ai tasti attualmente premuti, e un 
metodo per inviare le sequenze di tasti alla 
finestra attiva. 

• Mouse. L'oggetto My.Computer.Mouse mette 
a disposizione le proprietà che consentono di 
ottenere informazioni sul formato e la confi- 
gurazione del mouse installato sul computer 
locale. 

• Name. Permette di ottenere il nome del com- 
puter. 

• Network L'oggetto My.Computer.Network 
permette di accedere ai tipi e agli eventi della 
rete. 

• Ports L'oggetto My. Computer. Ports mette a 
disposizione una proprietà e un metodo per 
accedere alle porte seriali del computer. 

• Registry L'oggetto My. Computer. Registry per- 

mette di leggere e scrivere nel Registro di 
sistema. 



• Screen permette di ottenere l'oggetto Screen 
che rappresenta lo schermo principale del 
computer. 



L'OGGETTO 
MY.COMPUTER.AUDIO 

L'oggetto My.Computer. Audio mette a disposi- 
zione i metodi My.Computer. Audio. Play e 
My.Computer. Audio. PlaySystemSound che per- 
mettono di riprodurre file audio wav e suoni del 
sistema. 

Una caratteristica importante My.Computer. 
Audio è la possibilità di eseguire un file .wav, in 
modo sincrono oppure asincrono. Nel primo 
caso il metodo Play attende che venga completa- 
ta l'operazione prima di passare all'istruzione 
successiva. Nel secondo caso l'esecuzione del- 
l'audio avviene in background permettendo 
all'applicazione di eseguire altro codice mentre 
riproduce il suono, si può iterare l'esecuzione 
finché l'applicazione non esegue il metodo Stop. 
Utilizzando questa caratteristica si può, ad 
esempio, mantenere un suono in esecuzione 
mentre viene visualizzato un form. 
Per riprodurre un suono in maniera sincrona, 
possiamo scrivere: 

My.Computer.Audio.Play("C:\suono.wav", 

AudioPlayMode.WaitToComplete) 

Per riprodurre un suono in maniera asincrona, 
possiamo scrivere: 

My.Computer.Audio.Play("C:\suono.wav", 

AudioPlay Mode. Background) 

Il metodo Play permette la riproduzione di un 
solo suono in background per volta, quando l'ap- 
plicazione riproduce un nuovo suono in back- 
ground, interrompe il precedente. 
Per riprodurre un suono ciclicamente, in back- 
ground, fino a quando viene chiamato il metodo 
Stop, possiamo scrivere: 

My.Computer.Audio.Play("C:\suono.wav", 

AudioPlayMode. BackgroundLoop) 

Con l'oggetto Audio si possono leggere informa- 
zioni audio memorizzate in uno stream o in un 
array di tipo Byte, però l'unico formato suppor- 
tato è il formato Pulse-Code Modulation (PCM) 
standard; per questo motivo non è possibile 
riprodurre file MP3. In ogni caso questa caratte- 
ristica risulta molto comoda per eseguire piccoli 
suoni tesi a sottolineare un'azione o un evento 
dell'applicazione 
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IL FORMATO 
DEGLI APPUNTI 

I dati presenti negli 

Appunti possono 

essere di un formato 

qualsiasi, definito 

anche formato degli 

Appunti. Quando un 

elemento viene 

spostato o copiato 

negli Appunti, gli 

elementi in altri 

formati vengono 

cancellati. Per 

rendere persistenti 

gli altri formati, si 

può utilizzare 

DataObject, che 

permette di copiare 

tutto ciò che esiste 

negli Appunti 

correnti, inclusi gli 

elementi incollati da 

altre applicazioni. 

Negli Appunti è 

possibile inserire 

una intera classe, a 

patto che la classe 

sia serializzabile. 



MANIPOLARE 
LA CLIPBOARD 

L'Oggetto My. Computer. Clipboard fornisce i 
metodi che permettono la completa gestione 
degli appunti. Gli appunti sono condivisi da tutti 
i processi attivi sul PC e per questo motivo pos- 
sono essere utilizzati per memorizzare e trasferi- 
re dati, ad esempio testo, immagini e suoni tra le 
applicazioni. Gli elementi spostati o copiati negli 
appunti vengono conservati anche dopo la chiu- 
sura dell'applicazione. 

I metodi che permettono di leggere i dati dagli 
appunti sono: 

• GetText permette di leggere testo dagli Appunti. 

• Getlmage permette di leggere un'immagine 
dagli Appunti 

• GetData permette di leggere dati dagli 
Appunti. 

• GetAudioStream permette di leggere un flusso 
audio dagli Appunti 

• GetFileDropDownList permette di leggere un 
FileDropList dagli Appunti. 

Per scrivere dati negli appunti, si devono usare i 
metodi Set corrispondenti. 
Infine per determinare quale tipo di dato si trova 
memorizzato negli Appunti, è possibile utilizzare 
i metodi: ContainsAudio, Contains FileDropList, 
Containslmage e ContainsText. Per controllare 
un formato personalizzato, possiamo utilizzare il 
metodo ContainsData. 



E SCRIVERE UN TESTO 

Per scrivere dati di tipo testo negli Appunti si 
deve utilizzare il metodo SetText, per questo pos- 
siamo scrivere: 



messaggio standard 

MessageBox.Show(My.Computer.Clipboard.GetText()) 

Per il corretto funzionamento dell'esempio, è 
necessario che negli Appunti sia memorizzato 
un testo, altrimenti viene visualizzato un mes- 
saggio vuoto. 

Per cancellare il contenuto degli Appunti dobbia- 
mo utilizzare il metodo Clear. Il metodo Clear 
cancella i dati di qualsiasi formato e può avere 
effetto sugli altri processi condivisi. Possiamo 
scrivere semplicemente: 

My.Computer.Clipboard.Clear() 



UTILIZZARE 
AUDIO E IMMAGINI 

Per salvare i dati audio negli Appunti possiamo 

utilizzare il metodo: 

My. Computer. Clipboard. SetAudio. 

Se ad esempio vogliamo memorizzare il file 

audio pippo.wav dobbiamo: 

creare una matrice di byte MatriceMusicale 

Dim MatriceMusicale As Byte() 

Assegnare a MatriceMusicale il flusso di byte 
contenenti l'audio, utilizzando il metodo 
My.Computer.FileSystem.ReadAllBytes 

MatriceMusicale = 

My. Computer. FileSystem. ReadAIIBytesCpippo.wav") 

Memorizzare il valore della matrice negli appun- 
ti 

My.Computer.Clipboard.SetAudio(MatriceMusicale) 



My.Computer.Clipboard.SetText("Testo da 

memorizzare.") 

Il metodo SetText ammette come parametro il 
tipo di enumerazione TextDataFormat che per- 
mette di specificare il formato del testo da scrive- 
re. Se vogliamo, ad esempio, scrivere del testo in 
formato RTF: 

My.Computer.Clipboard.SetText("Testo da 

memorizzare.", _ 
System. Windows. Forms. TextData Format. Rtf) 

Per leggere il testo contenuto negli appunti dob- 
biamo utilizzare il metodo GetText, per questo 
possiamo scrivere il codice seguente, in cui il 
testo viene letto e visualizzato in una finestra di 



Per leggere un'immagine dagli Appunti possia- 
mo utilizzare il metodo: 
My. Computer. Clipboard. Getlmage. 
Scriviamo il codice necessario a recuperare 
un'immagine contenuta negli appunti ed asse- 
gniamola ad una PictureBox. 
Per prima cosa dobbiamo verificare che i dati 
contenuti negli appunti corrispondano ad una 
immagine, per questo motivo utilizziamo la fun- 
zione Containslmage. Nel caso in cui gli appunti 
contengono un'immagine, allora l'immagine 
viene mostrata nella PictureBox, in caso contra- 
rio mostriamo il messaggio di "Nessuna immagi- 
ne memorizzata" 



If My.Computer.Clipboard.ContainsImageQ 



True 
Then 
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pictureboxl.Image = 

My.Computer.Clipboard.GetImage() 



Else 



MsgBox("Nessuna immagine memorizzata") 



End If 



LAVORARE 
CON LA RETE 

L'Oggetto My. Computer. Network fornisce i meto- 
di che permettono l'interazione con la rete cui è 
connesso il computer. 

L'unica proprietà disponibile è la proprietà 
My. Computer. Network. IsAvailable. La proprietà 
IsAvailable restituisce True se il computer dispo- 
ne di una rete o di una connessione ad Internet 
attiva. Quando questa proprietà cambia, l'ogget- 
to scatena un evento 
NetworkAvailabilityChanged. Ad esempio pos- 
siamo scrivere il codice seguente che mostra a 
video lo stato della connessione in rete: 



If My. Computer. Network. IsAvailable = 


= True Then 


MsgBox( 


'Il Computer è connesso in rete.") 


Else 


MsgBox( 


'Nessuna rete dispon 


bile.") 


End If 



Per determinare la disponibilità di un computer 
remoto, si può utilizzare il metodo: 
My. Computer. Network. Ping 
Il metodo Ping accetta un nome di computer, 
oppure una URL, oppure un indirizzo IP ed un 
timeout opzionale. Il timeout viene espresso in 
millisecondi e, se non viene specificato, per 
impostazione predefinita assume il valore pari a 
500 millisecondi. Per verificare se il sito di 
IoProgrammo è raggiungibile dal nostro PC, pos- 
siamo scrivere: 

If My. Computer. Network. IsAvailable Then 
'Quando si specifica un URL, 
'non si deve includere http:// 

If My.Computer.Network.Ping( 

"www.ioprogrammo.it", 1000) Then 
MsgBox("Indirizzo raggiungibile") 

Else 

MsgBox("Non è possibile raggiungere il 

sito.") 

End If 

End If 

Il metodo DownloadFile, può essere utilizzato 
per eseguire il download di un file, oppure per 
leggere il contenuto di una pagina HTML identi- 
ficata dall'indirizzo URL. Questo metodo accetta 
come parametri opzionali il nome utente e la 



password, per questo motivo può essere utilizza- 
to anche con siti in cui è necessaria l'autentica- 
zione. È possibile, inoltre, mostrare una finestra 
di dialogo che mostri lo stato di avanzamento del 
download. 

Try 

My. Computer. Network. DownloadFile 

("http://www.ioprogrammo.it", _ 
"c:\Home Page IoProgrammo.html", 

Nothing, Nothing, True, 2000, False) 
Catch ex As Exception 

MessageBox.Show("II sito di destinazione 

non è raggiungibile") 
End Try 

Il metodo UploadFile è simile al metodo 
DownloadFile e accetta lo stesso insieme di argo- 
menti, fatta eccezione per il secondo parametro, 
che rappresenta il percorso del file che deve esse- 
re caricato in upload all'URL indicato come 
primo parametro. 



GESTIRE IL 
FILE SYSTEM 

L'oggetto My.Computer.FileSystem fornisce 
molti metodi per l'utilizzo di unità, file e direc- 
tory. Si possono, ad esempio: copiare, eliminare, 
spostare e rinominare sia singoli file sia intere 
directory. È possibile enumerare le cartelle ed i 
file di una directory, e persino leggere o scrivere 
un intero file di testo binario in una singola ope- 
razione. I metodi sono talmente tanti che non 
basterebbe l'intero articolo per analizzarli tutti, 
pertanto ci limiteremo ad osservarne alcuni. 

Per analizzare percorsi di file si possono utilizza- 
re i seguenti metodi: 
• Il metodo My.Computer.FileSystem. 

CombinePath richiede due percorsi e restitui- 
sce un percorso combinato opportunamente 
formattato. 
•5)11 metodo My.Computer.FileSystem. 

GetParentPath restituisce il percorso assoluto 
della directory padre del percorso indicato. 
•5)11 metodo My.Computer.FileSystem. 

GetFilelnfo restituisce un oggetto Filelnfo di 
cui è possibile determinare le proprietà del 
file, ad esempio il nome e il percorso. 

Se vogliamo determinare il nome ed il percorso 
di un file restituito dal metodo GetFilelnfo, pos- 
siamo utilizzare le proprietà Directory Name e 
Name dell'oggetto Filelnfo restituito: 

Dim FileDiTest As System. IO. Filelnfo 




IL METODO 
PING 

Il metodo Ping non 
è infallibile nel 
determinare la 
disponibilità di un 
computer remoto. 
Può portare a 
risultati errati 
poiché la porta del 
ping sulla macchina 
di destinazione può 
essere spenta 
oppure la richiesta 
di ping può essere 
bloccata da un 
firewall o da un 
router. 
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FileDiTest = 
My.Computer.FileSystem.GetFileInfo("C:\MiaCartella\ 

MioFile.txt") 



Dim Cartella As String 



FileDiTest. DirectoryName 



'mostra l'intero percorso C:\MiaCartella 



MessageBox.Show(Cartella) 



Dim NomeFile As String = FileDiTest. Name 



'mostra MioFile.txt 



MessageBox.Show(NomeFile) 

Alcuni metodi hanno la caratteristica di visualiz- 
zare una finestra di dialogo Windows standard, 
quando eseguono un'operazione su file da cui è 
possibile rilevare se l'utente clicca sul pulsante 
Cancel per interrompere l'azione. Se, ad esem- 
pio, vogliamo copiare un'intera directory, possia- 
mo utilizzare il metodo CopyDirectory, scrivendo 
il seguente codice: 

Try 

My. Computer. FileSystem. CopyDirectory 

("C:\IoProgrammo", _ 
"C:\Backup", FilelO.UIOption.AIIDialogs, 

FilelO.UICancelOption.ThrowException) 
Catch ex As Exception 

MessageBox.Show("Operazione cancellata 

dall'utente") 
End Try 

Quando si avvia l'operazione, viene mostrata la 
finestra in figura 

I metodi CopyFile, MoveDirectory, MoveFile, 
DeleteDirectory e DeleteFile presentano le stesse 
caratteristiche di CopyDirectory. Gli ultimi due 
metodi elencati hanno una ulteriore opzione che 
permette di inviare i file e le directory eliminate 
nel cestino di sistema oppure di eliminarli defini- 
tivamente senza passare dal cestino 



Copia in corso. 



J 



J 



08 Stored Procedure.doc 

Da "Libro Io Programmo 2" a "Libro Io Programmo 2" 

4 minuti alla fine del processo 



Annulla 



Fig. 2: Una finestra informativa per la copia dei File 



INFORMAZIONI 
SUL COMPUTER 

Gli oggetti di My Computer: Clock, Info, Keyboard, 
Mouse, Ports e Screen espongono, in buona 
sostanza, una serie di proprietà a sola lettura che 



permettono di recuperare le informazioni sul 
sistema. Il codice seguente mostra in un TextBox 
una serie di informazioni ricavabili da questi 
oggetti: 

Dim Informazioni As String = "" 

Informazioni = Informazioni & "Data ed Ora Locale " 

& My.Computer.Clock.LocalTime & vbCrLf 
Informazioni = Informazioni & "Memoria Fisica " & 

My.Computer.Info.AvailablePhysicalMemory & vbCrLf 
Informazioni = Informazioni & "Memoria Virtuale " & 

My.Computer.Info.AvailableVirtualMemory & vbCrLf 

Informazioni = Informazioni & "Sistema operativo " & 

My.Computer.Info.OSFullName & vbCrLf 

If My.Computer.Keyboard.CapsLock Then 

Informazioni = Informazioni & "il tasto BLOC 
MAIUSC è attivo" & vbCrLf 

Else 

Informazioni = Informazioni & "il tasto BLOC 
MAIUSC NON è attivo" & vbCrLf 



End If 



If My.Computer.Mouse.WheelExists Then 
Informazioni = Informazioni & "il Mouse 
presenta la rotella di scorrimento" & vbCrLf 

Else 

Informazioni = Informazioni & "il Mouse non 
presenta la rotella di scorrimento" & vbCrLf 
End If 
Informazioni = Informazioni & "Lo schermo presenta 
i seguenti Bits Per Pixel " & 
My.Computer.Screen.BitsPerPixel & vbCrLf 
Informazioni = Informazioni & "Risoluzione 
Orizzontale" & My.Computer.Screen.Bounds.Width & 

vbCrLf 

Informazioni = Informazioni & "Risoluzione Verticale" 



. -i .... a ,,,r 006 1 "•'. 
Fisica 29970841 G 
Memoria Virtuale 1 9931 17G9G 

1 ii ii i * il i li r i MI i n'i » i il 

ili- toLLOCri-iii^.: unric 5.» .. 

i! Mcli:i p[.;:-niìi la n'ih di .coinr.iwiiM 

■ , - i i n I . ii - i' n 

r , -,i zio e Orizzontai \', '<■" 
FI isoli mone Verticale'! 024 




Fig. 3: Ecco le informazioni sul sistema 



& My.Computer.Screen.Bounds.Height & vbCrLf 
TextBoxl.Text = Informazioni 

La maggior parte delle informazioni esposte da que- 
sti oggetti sono disponibili utilizzando altri tipi del 
.NET Framework, ma l'oggetto My.Computer offre 
una soluzione più semplice da utilizzare. 

Luigi Buono 
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APPLICAZIONI 
DESKTOP IN JAVA 6 

VEDIAMO, ATTRAVERSO ESEMPI UTILI, LE NUOVE FUNZIONALITÀ INTRODOTTE SULLO 
SVILUPPO DESKTOP DA JAVA 6 MUSTANG, CHE AVVICINANO DI PIÙ JAVA AL SISTEMA 
OPERATIVO PUR MANTENENDO SEMPRE LA SUA CARATTERISTICA DI PORTABILITÀ 




Nel mese scorso è stata rilasciata da 
SUN la prima Beta ufficiale di Java 6, 
nome in codice "Mustang". La versio- 
ne "ufficiale" è prevista per la fine del 2006. 
Nonostante si tratti di una Beta, si intravede 
già la direzione che caratterizzerà il linguag- 
gio di SUN nei prossimi anni. Le novità intro- 
dotte sono molte e coinvolgono diversi aspet- 
ti. In quest'articolo parleremo principalmente 
delle novità riguardanti le interfacce utente 
(GUI) che possono essere realizzate con Java. 



re i programmi di default associati ai tipi fi file. 
Allo stesso modo è possibile aprire URL e 
client email di default del sistema 



SPLASHSCREEN 

Prima di Java 6, per poter visualizzare uno 
SplashScreen alla partenza del programma, aveva- 
mo bisogno di visualizzare un JFrame per pochi 
secondi. Un esempio di codice è il seguente: 




■ imi il li ii'i ^ 

- J2SE 

m J2SE 6 Mustang SDK 

00™ 



Tempo di realizzazione 



SVILUPPO 

DI UN GESTIONALE 

L'applicazione che svilupperemo e che ci farà 
da guida per la scoperta delle nuove funziona- 
lità desktop di Java 6 sarà un gestionale. Come 
in ogni gestionale avremo bisogno di gestire 
dati con tabelle, di aprire file e mandarli in 
stampa e di gestire scelte dell'utente. 
Chiaramente non analizzeremo lo sviluppo di 
tutto il gestionale, che alla fine è una sempli- 
ce applicazione Swing, ma ci soffermeremo 
sui punti che riguardano le novità introdotte 
da Mustang in ambito desktop, ovvero 

• Splashscreen: È possibile, a livello nativo, 
avere uno Splashscreen dell'applicazione, 
ovvero un'immagine visualizzata all'avvio, 
prima del completo caricamento del pro- 
gramma 

• Migliore gestione dell'elemento JTable: 
ordinamento e filtraggio dei valori 

• Tray icon: finalmente è possibile vedere la 
propria applicazione Java nella barra delle 
applicazioni in esecuzione, senza dover 
ricorrere a JNI (Java Native Interface) 

• Desktop: Finalmente è possibile da Java awia- 



JFrame frame = new J Fra me( "Vecchio Splash"); 
frame.setDefaultCloseOperation(JFrame.EXIT_ON_C 

OSE); 

JLabel label = new JLabel("Vecchio Splash", 

J Label. CENTER); 
frame. getContentPane().add(label, 

BorderLayout.CENTER); 
frame. setSize(300, 100); 



frame. setVisible(true); 



Thread.currentThread().sleep(5000); 
frame. getContentPane().remove(frame); 



frame. disposeQ; 



System. out.println("Ora parte il programma..."); 

Chiaramente il look di questa finestra iniziale 
lascia molto a desiderare, pur sforzandosi di 
ottenere risultati apprezzabili, era difficile 
ottenere una qualità vicina a quella degli spla- 
shscreen tradizionali. Con Java 6 la soluzione 
è molto più semplice ed elegante. Dal prompt 
dobbiamo semplicemente avviare l'applica- 
zione in questo modo 

java -splash: test. png Test 

Per visualizzare correttamente lo splash- 
screen possiamo semplicemente sospendere 
il Thread principale dell'applicazione per 5 
secondi all'avvio. In questo modo verrà 
mostrato lo splashscreen, poi appena il 
Thread riprenderà l'esecuzione, all'inseri- 
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mento del primo oggetto grafico, lo splash- 
screen scomparirà. 

Thread.currentThread().sleep(5000); 

System. out.println("Ora parte il programma..."); 

JFrame frame = new Jframe("Un vero 

SplashScreen"); 
frame. setDefauItCloseOperation 

(JFrame.EXIT_ON_COSE); 

JLabel label = new JLabel("Un vero SplashScreen", 

J Label. CENTER); 
frame. getContentPane().add(label, 

BorderLayout.CENTER); 



frame. setSize(300, 100); 



frame. setVisible(true); 




Fig. 1: Un esempio di SplashScreen 

L'immagine può essere definita da linea di 
comando o attraverso il manifest dell'applicazio- 
ne. Chiaramente nel secondo caso è possibile 
includere l'intera applicazione (immagine com- 
presa) in un file jar. L'attributo che deve essere 
usato nel file manifest è SplashScreen-Image. Qui 
di seguito mostriamo l'esempio di un manifest nel 
quale viene incluso questo attributo per poter 
visualizzare l'immagine come splashscreen. 

Manifest-Version:1.0 

Class-Path: lib/libreria.jar 

Main-Class: com.javastaff.TestSplashScreen 

SplashScreen-Image: test. gif 

Oltre a questi due metodi per la gestione degli 
SplashScreen, Java 6 fornisce anche una clas- 
se apposita all'interno del package java.awt. 
Questa classe espone una serie di metodi per 
poter manipolare l'oggetto grafico Splash 
Screen tramite Graphics2D, che consente di 
gestire grafica 2D in maniera semplice. 



LA GESTIONE 



deve ricevere dei dati in input, elaborarli e 
presentare un output adeguato all'utente. In 
questo, come in tanti altri programmi gestio- 
nali, il tutto passa attraverso la visualizzazio- 
ne dei dati attraverso una JTable. Questa è una 
classe grafica che dalle prime versioni di 
Swing in poi è collocata nei package di Java 
Standard. Permette di gestire un oggetto grafi- 
co che rappresenta una tabella classica come 
quelle di Excel o altri programmi simili. In 
Mustang sono state introdotte nuove feature 
riguardanti questa classe. Prima di Java 6 era 
possibile effettuare l'ordinamento di una 
JTable, ovvero ordinare i dati della tabella in 
base al valore crescente o decrescente di un 
campo. Per fare questo però veniva richiesto 
un bel po' di codice. Mustang introduce un 
nuovo modo di realizzare l'ordinamento che 
semplifica molto il lavoro. Vediamone un 
esempio nel seguente codice 

import javax. swing.*; 
import javax. swing. table.*; 
import java.awt.*; 



public class EsempioOrdinamento { 



Il programma d'esempio che stiamo usando 
come laboratorio per i nostri esperimenti 



public static void main(String args[]) { 

String colonne[] = {"Sito", "URL"}; 

String righe[][] = {{"JavaStaff.com", 

"http ://www.javastaff.com"}, 
{"News Google", "http://news.google.it"}, 
{"JavaLobby", 

"http ://www.javalobby.com"}, 
{"HostingJava", 

"http://www.hostingjava.it"}, 
{"IBM Redbooks", 

"http://www.redbooks.ibm.com"}, 
{"JavaCrawler", 

"http://www.javacrawler.com"}, 

>} 

TableModel tableModel = 

new DefaultTableModel(righe, colonne) { 
public Class getColumnClass(int column) { 
Class returnValue; 
if ((column >= 0) && (column < 

getColumnCount())) { 
returnValue = getValueAt(0, 

column). getClass(); 

} else { 

returnValue = Object. class; 

} 

return returnValue; 

} 

}; 

JTable table = new JTable(tableModel); 
RowSorter<TableModel> rowSorter = new 

TableRowSorter<TableModel>(tableModel); 
table. setRowSorter( rowSorter); 
JFrame frame = new JFrame("JTable 
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esempio"); esempio di codice mostra come fare 



frame.setDefauItCloseOperation 
(JFrame.EXIT_ON_CLOSE); 

JScrollPane pane = new JScrollPane(table); 

frame.add(pane, BorderLayout. CENTER); 



frame.setSize(350, 200); 



frame.setVisible(true); 



} 



Analizziamo ora il codice per capire cosa succe- 
de. Prima di tutto definiamo due array di strin- 
ghe che rappresentano le righe e le colonne della 
JTable. Passiamo quindi alla definizione di un 
TableModel. Questa interfaccia ci permette di 
definire i metodi che la JTable utilizzerà. La parte 
che ci permette di definire l'ordinamento viene 
implementata con la definizione di RowSorter, al 
quale passiamo il modello dei dati. 
L'ordinamento viene effettuato sulla base del 
metodo che abbiamo ridefinito {getColumn 
Class). Come potete vedere il modello dei dati 
viene utilizzato sia da JTable che da RowSorter. 
Questo è solo uno dei modi per poter ordinare gli 
elementi in una JTable, a mio avviso quello più 
semplice. 



f JTable esempio 


,Jn]x| 


Sito » 


URL 


News Google 


http://news.google.it 


JavaStaff.com 


http ://www.j ava staff, e o m 


Java Lobby 


http ://www.j ava 1 o b by.c o m 


JavaCrawler 


http ://www.j ava e ra wl er.com 


IBM Redbooks 


http:/Awww. redbooks. ibm.com 


Hosting Java 


http ://www. h o sti n gj ava . it 



Fig. 2: Ordinamento di una JTable 



ALTRI METODI DI ORDII\IAMEI\ITO> 



Le API che sono state aggiunte in 
Mustang forniscono altre classi e 
interfacce per manipolare questo 
tipo di dati e gli eventi associati. 
Per un maggior approfondimento 



su questo tema vi rimando alla 
documentazione ufficiale del 
package javax.swing.table e delle 
altre classi correlate 

(http://java.sun.eom/javase/6/docs/api). 



FILTRI SUI CONTENUTI 

Supponiamo di avere una lunga lista di ogget- 
ti e volere visualizzare soltanto quelli che sod- 
disfano una certa regola. Nell'esempio prece- 
dente mostravamo una lista di siti con i relati- 
vi uri, Vediamo come creare un filtro che ci 
mostri soltanto quelli che contengomo una 
certa stringa all'interno del nome. Fobbiamo 
definire un JTextField per l'input dell'utente e 
un listener che filtra la tabella ogni volta che 
viene cambiato il testo dall'utente. Il seguente 



import javax. swing. 



import javax.swing.table/ 



import javax. swing. text. : 



import javax. swing. event. : 



import java.awt.event. : 



import java.awt. : 



public class EsempioFiltraggio { 



public static void main(String args[]) { 



String colonne[] = {"Sito", 



"URL"}; 



String righe[][] = 
{{"JavaStaff.com", "http://www.javastaff.com"}, 



{"News Google", 

"http://news.google.it"}, 



{"JavaLobby", 
"http://www.javalobby.com"}, 



{"HostingJava", 

"http://www.hostingjava.it"}, 



{"IBM Redbooks", 
"http://www.redbooks.ibm.com"}, 



{"JavaCrawler", 
"http://www.javacrawler.com"}, 



>; 



JFrame frame = new 

JFrame("JTable esempio"); 



frame.setDefauItCloseOperation 

(JFrame. EXIT_ON_CLOSE); 



TableModel tableModel 



new DefaultTableModel(righe, 

colonne) { 



public Class getColumnClass(in 

column) { 



Class returnValue; 



if ((column >= 0) && (column 
< getColumnCount())) { 



returnValue = getValueAt(0, 

column). getClassQ; 



} else { 



returnValue = Object. class; 



} 



return returnValue; 



} 



>; 



JTable table = new 

JTable(tableModel); 



final TableRowSorter<TableModel> 

rowSorter = new 

TableRowSorter<TableModel>(tableModel); 



table. setRowSorter(rowSorter); 



final JTextField testoFiltro=new 

JTextField(""); 



testoFiltro.addActionl_istener(new 



ActionListenerQ { 



public void 
actionPerformed(ActionEvent event) { 



String 
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testo=testoFiltro.getText(); 



(testo. equals("")) 



rowSorter.setRowFilter(null); 



else { 



try{ 



rowSorter.setRowFilter(RowFilter.regexFilter(testo)); 



> 



catch(Exception e) { 



System. out.println(e.toString()); 



> 



}); 



JScrollPane pane = new 

JScrollPane(table); 



frame.add(testoFiltro, 

BorderLayout.NORTH); 



frame.add(pane, 

BorderLayout.CENTER); 



frame.setSize(350, 200); 



frame.setVisible(true); 



} 



In questo caso utilizziamo un TableRowSorter al 
posto del RowSorter che avevamo utilizzato nel- 
l'esempio precedente. Abbiamo aggiunto un 
JTextField per avere un campo di input. A questo 
componente è associato un ActionListener che 
viene attivato ogni volta scriviamo qualcosa e 
mandiamo a capo. In questo caso viene preso il 
contenuto del JTextField e viene richiamato il 
metodo setRowFilter. Così facendo il contenuto 
viene filtrato e la nostra tabella visualizza soltan- 
to le righe che hanno il testo inserito nel 
JTextField. 





| l£ JTable esempio 


[-FP 


Java 


Sito 


URL 


JavaStafT.com 


http JFwwwj ava staff, e o m 


Java Lobby 


http :tfwww.j ava 1 o b by. e o m 


HostingJava 


http flwww. hosting] ava . it 


JavaCrawler 


http ://www.j ava e ravvi er.com 





Fig. 3: Una jtable disordinata 



SYSTEM TRAY 
& TRAY ICOIU 

Nella maggior parte delle applicazioni 
Desktop abbiamo la possibilità di avere un 
menu nella System Tray (ovvero nella barra in 
basso a destra). Precedentemente a Mustang 



era possibile utilizzare la System Tray, ma solo 
attraverso delle librerie opensource. Ora inve- 
ce è possibile avere queste funzionalità con la 
distribuzione standard di Java. Chiaramente 
non è una delle più importanti opzioni che 
deve avere un programma, ma comunque fa 
parte di quelle qualità di usabilità che devono 
far parte di un software Desktop al giorno 
d'oggi. Senza utilizzare la System Tray poteva- 
mo semplicemente minimizzare la finestra 
che stavamo utilizzando, che però rimaneva 
comunque nella barra della applicazioni. Per 
fare ciò si poteva semplicemente cambiare lo 
stato del JFrame e farlo minimizzare come 
tutte le applicazioni grafiche, come viene illu- 
strato nel seguente esempio 

import java.awt.BorderLayout; 
import java.awt.Rectangle; 
import java.awt.event.ActionEvent; 



import java. awt.event. ActionListener; 
import javax. swing. JButton; 



import javax. swing. JFrame; 



import javax. swing. JPanel; 



public class MinimizzaFrameOld extends JFrame 

implements ActionListener { 



private JPanel pannello; 



private JButton bottonel; 



private JButton bottone2; 



public MinimizzaFrameOldO { 



try { 



pannello=new JPanelQ; 



pannello. setLayout(new 
BorderLayoutQ); 



bottonel = new 



JButton(); 



bottonel. setText("Minimizza"); 



bottonel. addActionListener(this); 



bottone2=new 



JButton(); 



bottone2.setText("Invisibile"); 



bottone2.addActionListener(this); 



pannello.add(bottonel,BorderLayout.NORTH); 

pannello.add(bottone2,BorderLayout.SOUTH); 

this.getContentPane().add(pannello, 

BorderLayout.CENTER); 

this.setSize(200,100); 

this.setVisible(true); 

} 

catch(Exception e) { 
System. out.println(e.toString()); 

} 

} 

public void actionPerformed(ActionEvent 

event) { 



if(event.getSource() 



bottonel) { 



this.setExtendedState(this.ICONIFIED); 




DOVE POSSO 
SCARICARE 
JAVA 6? 

La beta di Java 6 è 

scaricabile 

dall'indirizzo 

http://java.sun.com/javase/ 
6/download.jsp 
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} 


else if(event.getSource() = = 


bottone2) { 
this.setVisible(false); 


} 


} 


public static void main(String[] ar) { 


MinimizzaFrameOld mf = new 

MinimizzaFrameOld(); 


} 


} 



L'esempio riportato crea un semplice JFrame 
e aggiunge due JButton. Su tutti e due i botto- 
ni vengono aggiunti degli ActionLis tener , per 
sapere quando sono stati premuti. Premendo 
il primo bottone facciamo semplicemente 
abbassare la nostra finestra, settando lo stato 
del nostro JFrame a ICONIFIED. Il secondo 
bottone invece rende invisibile il nostro 
frame, utilizzando il metodo setVisibleQ . Così 
facendo non possiamo comunque permettere 
all'utente di riaprire l'applicazione, visto che 
non può più vedere il frame principale. 
Utilizzando invece la System Tray possiamo 
decidere che quando l'utente vuole minimiz- 
zare la nostra applicazione, questa scompare 
e successivamente può essere riportato in 
primo piano semplicemente cliccando sull'i- 
cona. Prima di tutto dobbiamo controllare se 
la versione che stiamo utilizzando supporta la 
System Tray 

if (SystemTray.isSupportedO) 

aggiungiSystemTray(mf); 

Passiamo quindi alla definizione della System 
Tray. Dobbiamo catturare l'evento clic del 
mouse e soprattutto dobbiamo render dispo- 
nibile un comando per uscire dall'applicazio- 
ne, perchè anche quando clicchiamo sulla X 
della finestra in realtà rendiamo invisibile il 
frame, ma non chiudiamo l'applicazione. 

public static void 

aggiungiSystemTray(MinimizzaFrame mf) { 
final Traylcon traylcon; 
final MinimizzaFrame mfm=mf; 



SystemTray tray = 

SystemTray.getSystemTrayO; 



Image image = 
Toolkit.getDefaultToolkit(). getlmage("tray.gif"); 

MouseListener mouseListener = 

new MouseListenerQ { 



public void 
mouseClicked(MouseEvent e) { 



System. out.println("Evento del mouse"); 



mfm.setVisible(true); 



} 



public void 



mouseEntered(MouseEvent e) { 



} 



public void 
mouseExited(MouseEvent e) { 



} 



public void 
mousePressed(MouseEvent e) { 



} 



public void 
mouseReleased(MouseEvent e) { 



} 



}; 



ActionListener listener = new 

ActionListenerQ { 



public void 

action Performed (Action Event e) { 



System. out.println("Uscita dal 

programma"); 



System. exit(O); 



PopupMenu popup = new PopupMenuQ; 



Menultem defaultltem = new 



MenuItem("Esci"); 



defaultltem. addActionListener(listener); 



popup. add(defaultltem); 



traylcon = new TrayIcon(image, 

"MinimizzaFrame", popup); 



traylcon. setlmageAutoSize(true); 



traylcon. addMouseListener(mouseListener); 



try { 



tray.add(traylcon); 



} catch (Exception e) { 



System. out.println(e.toString()); 



> 



Analizziamo ora cosa succede. Prima di tutto 
viene istanziato un oggetto SystemTray utiliz- 
zando il metodo statico getSystemTrayQ della 
stessa classe. Questo oggetto rappresenta la 
SystemTray, dove noi andiamo ad aggiungere 
la nostra icona, con il relativo menu. La classe 
che ci permette di aggiungere l'icona è 
Traylcon, che inizializziamo con un'immagi- 
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ne, una stringa ed un Menu. Questo menu è il 
classico PopupMenu, dove possiamo aggiun- 
gere semplici elementi Menultem oppure cose 
più elaborate tipiche di Swing. In questo caso 
viene aggiunto un semplice elemento, che ci 
permetterà di uscire dall'applicazione. Per 
capire che l'icona è stata cliccata dobbiamo 
semplicemente aggiungere alla nostra 
Traylcon un MouseListener, nel quale imple- 
mentiamo soltanto il metodo mouseClicked. 
MouseListener è un'interfaccia che ci notifica 
gli eventi relativi al mouse. In questo metodo 
settiamo semplicemente a true la visibilità del 
frame, permettendo quindi alla nostra appli- 
cazione di sparire e riapparire dal desktop. 









(01 risiisi 




Minimizza 






Invisibile 








■ 'l r 


1 ^MinirmizzaFrami 


/ Immagine -P... 1 |« É 5 fi 16, 



Fig. 4: Icona dell'applicazione nella barra di sistema 



DESKTOP API 

Veniamo ora alla parte più interessante 
(almeno a mio avviso) della piattaforma 
Mustang lato Desktop. Abbiamo già visto che 
le precedenti feature che sono state introdot- 
te cercano di dare sempre più potere alle 
applicazioni Java, rendendole sempre più 
integrate nel sistema operativo dove devono 
girare. Uno dei problemi storici delle applica- 
zioni Java Desktop è stato appunto quello di 
avere poteri limitati rispetto a programmi 
scritti con linguaggi di programmazione nati- 
vi come C e C++. Un altro grande problema è 
sempre stato il Look & Feel delle applicazioni, 
che si discostava molto da quello classico di 
tutte le applicazioni grafiche. Con Mustang si 
è voluto appunto riawicinare il mondo di Java 
al Desktop e una delle API più interessanti in 
questo senso è la Desktop API. Questa per- 
mette allo sviluppatore Java di interagire con 
il sistema operativo, in un modo sicuramente 
maggiore rispetto a quello che veniva prece- 
dentemente offerto. Questa API deriva dal 
progetto opensource JDIC (JDesktop 
Integration Components), che è stato inglo- 
bato all'interno dell'ultima release di casa 



SUN. Quello che ora vedremo è la classe 
Desktop, che ci permette di 

• Avviare il browser predefinito 

• Avviare il client di posta predefinito 

• Aprire un file con l'applicazione ad esso 
associata 

• Modificare un file con l'applicazione ad 
esso associata 

• Stampare un file 

Incominciamo a vedere un po' di codice, 
riguardante le prime due feature, ovvero 
come poter avviare browser e client di posta. 

import java. awt. Desktop; 
import java. io.*; 



import java.net. 



public class EsempioBrowserMail { 



private static Desktop desktop; 



public static void main(String a[]) { 



(Desktop. isDesktopSupported()) { 
desktop = 
Desktop. getDesktop(); 

} 

else { 
System. out.println("In questo sistema non è 

abilitato il supporto Desktop"); 
System. exit(0); 

} 

System. out.println("Apriamo il browser"); 
lanciaBrowser("www.javastaff.com"); 



System. out.println("Apriamo il client email"); 
lancia Mai ICIient("doc@javasta ff.com"); 



> 



In questo primo pezzo di codice effettuiamo il 
controllo relativo al supporto alla JDesktop 
API. Qesto controllo deve essere effettuato 
perché non tutti i sistemi operativi potrebbe- 
ro supportarlo. Se la feature che vogliamo uti- 
lizzare è supportata allora passiamo diretta- 
mente all'esecuzione dei due metodi che lan- 
ciano il browser e il client email. 



public 


static void 


lanciaBrowser(String testo) { 


URI uri = nuli; 


try { 


uri = new URI(testo); 


desktop, browse(uri); 


} 


catch(Exception e) { 


System. out.println(e.toString()); 




LA SYSTEM 
TRAY ll\l JAVA 5 

Prima di Mustang era 
già possibile utilizzare 
la System Tray in Java. 
Sono infatti presenti 
nel panorama 
opensource diverse 
librerie che 
permettono di 
interagire con la 
System Tray senza 
utilizzare l'ultima 
versione di Java 

• Jan Struyf "s Windows 
Tray Icon 

http://jeans.studenten 
web.org/java/trayico/tr 
ayicon.html 

• systray4j 

http://systray.sourcefor 
ge.net 

• JDIC 
https://jdic.dev.java.net 

• Eclipse SWT Tray 
http://wiki.eclipse.Org/i 
ndex.php/Development 
_Resources 
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L'AUTORE 



L'autore, Federico 

Paparoni, può essere 

contattato per 

suggerimenti o 

delucidazioni 

all'indirizzo email 

federico.paparoni@javast 

aff.com 



} 



In questo metodo non facciamo altro che ini- 
zializzare un oggetto URI, passando come 
parametro la stringa dell'argomento. Se quel- 
lo che abbiamo passato non è un URI 
(Uniform Resource Identifier) allora verrà lan- 
ciata un'eccezione. Se invece riusciamo ad 
inizializzare l'oggetto dobbiamo solo richia- 
mare il metodo browse di Desktop e il browser 
predefinito si awierà cercando di aprire quel- 
lo che abbiamo richiesto. Passiamo ora al 
client email 

public static void lanciaMailClient(String testo) { 
URI uri = nuli; 

try{ 

if (testo.lengthQ > 0) { 

uri = new URI("mailto", 
testo, nuli); 
desktop, mail(uri); 
} else { 

desktop. mailQ; 



un file utilizzando sempre la Desktop API 



Desktop desktop; 



String filename = "e: \\prova.txt" 



File f = new File(filename); 



if (Desktop. isDesktopSupported()) { 

desktop = Desktop. getDesktopQ; 



else { 



System. exit(); 



try { 



//APRIAMO IL FILE 



desktop. open(file); 



//MODIFICHIAMO IL FILE 



desktop. edit(file); 



//STAMPIAMO IL FILE 



desktop, print(file); 



} 



catch(Exception e) { 



System. out.println(e.toString()); 



_} 

catch(Exception e) { 

System. out.println(e.toString()); 

} 



} 



Anche in questo metodo creiamo un oggetto 
URI, al quale passiamo l'email che abbiamo 
passato come parametro. Successivamente 
richiamiamo il metodo mail{) di Desktop che 
avvia il client di posta predefinito. Vediamo 
infine come poter aprire, modifica e stampare 



CONCLUSIONI 

Abbiamo visto che le nuove funzionalità di 
Mustang permettono di avere delle applicazioni 
grafiche migliori rispetto alle vecchie versioni di 
Java. C'è da dire che anche le prestazioni di que- 
sta versione sembrano essere migliorate rispetto 
alle precedenti. Le novità introdotte nella grafica 
non sono solo quelle che abbiamo visto, infatti 
molte riguardano anche lo sviluppo enterprise. 
Come sempre il passaggio ad una nuova versione 
ricca di novtià così importanti richiederà un po' 
di tempo, tuttavia siamo certi che le innovazioni 
apportate favoriranno una transizione rapida. 

Federico Paparoni 



IL PROGETTO JDESKTOP INTEGRATION COMPONENTS 



Molte delle attese che si sono 
formate intorno al nascente 
Java 6 ruotano al progetto 
JDIC, ovvero J Desktop 
Integration Components. 
Come avrete 

abbondantemente appreso 
da questo articolo JDIC si 
propone una maggiore 
integrazione fra Java e i 
sistemi su cui i programmi 
Java devono ruotare. L'intero 
progetto nasce sul sito 
javadesktop.org, e da qui si 
possono reperire 
informazioni complete su 
tutte le funzionalità che ne 



caratterizzeranno l'uso in 
Mustang, ovvero Java 6. Le 
motivazioni che hanno 
indotto Sun a scegliere 
questa direzione sono 
molteplici. Prima di tutto si è 
tenuto conto della crescente 
diffusione di Linux sul lato 
Desktop. In secondo luogo ci 
si è resi conto della comodità 
di poter utilizzare 
un'interfaccia Standalone 
rispetto ad un'interfaccia 
Web. Infine la tecnologia 
"Java Web Start" sembra 
avere riscosso un certo 
successo. Tutti motivi per cui. 



la scelta di favorire lo 
sviluppo di applicazioni 
maggiormente integrate con i 
Desktop in cui vivono sembra 
essere vincente.D'altra parte 
Java ha alcune cose in 
comune con HTML e con le 
applicazioni che girano in un 
Browser, ovvero la possibilità 
di funzionare allo stesso 
modo su qualunque 
piattaforma. Rispetto alle 
web application ha dalla sua 
parte la possibilità di girare 
con delle interfacce 
standalone. Purtroppo fino a 
ieri queste enormi possibilità 



non erano supportate da una 
serie di API che potessero 
sfruttare a fondo il sistema 
operativo ospite. Con 
Mustang e JIC questa lacuna 
viene finalmente colmata. Il 
lavoro è stto duro, in quanto 
si doveva fare in modo di 
garantire lo stesso look & fee 
adottato dal sistema, con 
l'ambiente Java, ma alla fine 
il risultato è soddisfacente. 
Java 6 sarà in grado di 
utilizzare menu, popup, 
bottoni, barre, e colori del 
sistema operativo su cui le 
applicazioni girano. 
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ReactOS 0.3.0 Rei 

IL PRIMO CLONE OPENSOURCE DI MICROSOFT WINDOWS 



ReactOS è un progetto che da tempo fa 
parlare di se. L'intenzione era ed è quel- 
la di creare un sistema operativo com- 
pletamente OpenSource con compatibi- 
lità binaria con gli eseguibili di 
Windows. Recentemente è stata rila- 
sciata la Release Candidate 1 della ver- 
sione 3 che ha raggiunto una maturità 
tale da portare il progetto, finalmente, 
su un piano pratico. In realtà lo scopo 
degli sviluppatori di ReactOS non è 
semplicemente quello di emulare il più 
noto fratello maggiore e di raggiungere 
la compatibilità binaria con gli esegui- 
bili, piuttosto quello di continuare ad 



innovare, di modo da poter raggiunge- 
re lo stato dell'arte della tecnologia con 
un sistema che diventerebbe non un 
esatto clone di Windows, ma un suo 
derivato che ne estenderebbe e ne 







migliorerebbe la qualità. La sfida è dif- 
ficile. Molto affidamento viene fatto 
sulla disponibilità dei sorgenti, grazie ai 
quali si spera che molti programmatori 
contribuiranno allo sviluppo con moda- 
lità che sono tipiche dei software 
OpenSource. La sfida è emozionante, 
tanto che noi stessi in queste pagine vi 
presentiamo sia una versione live che vi 
consente di valutare lo stato d'avanza- 
mento del progetto, sia i sorgenti della 
versione 0.3.0 RC1 di modo che chiun- 
que di voi possa, se vuole, contribuire 
allo sviluppo 
Directory:/ ReactOS 



HIBERNATE 3.1.3 

METTE D'ACCORDO SQL E 
PROGRAMMAZIONE OBJECT 
ORIENTED 

Ne parliamo spesso su ioProgrammo, in 
quanto si tratta di uno dei problemi che 
sta maggiormente influenzando il modo 
di programmare nell'ultimo anno. Come 
far si che la logica del linguaggio SQL sia 
integrata nel modo di pensare ad oggetti 
tipico di un programmatore? 
Il tool che più di ogni altro ha fatto passi 
da gigante in questo settore è Hibernate, 
che grazie a semplici file XML riesce a 
trasformare, tabelle, righe, colonne, celle 
di un database nelle corrispondenti 
Classi di codice. In questo numero pre- 
sentiamo un primo articolo scritto dal 
bravo Fabrizio Fortino che ci illustra 
appunto come questo framework può 
migliorare la qualità della programma- 
zione. Nell'articolo viene anche presen- 
tato un plugin per Eclipse, che come 
sempre non manca di estensioni che 



facilitano lo sviluppo. 
Directory:/ Hibernate 

SKYPE CONTACTS 

LE API PER SVILUPPARE 
ESTENSIONI PER SKYPE 

Skype è stato il primo software a 
mostrare la potenza del voice over ip. 
Attualmente è usato da milioni di 
utenti in Italia e nel mondo. In questo 
numero di ioProgrammo vi presen- 
tiamo un bell'articolo del nostro 
Paolo Perrotta che mostra come scri- 
vere un bot autorisponditore per 
Skype. Strumento essenziale per 
compiere questa operazione, oltre 
allo stesso Skype anche una serie di 
oggetti COM che fanno da interfaccia 
fra il nostro codice e Skype stesso. La 
tecnica è affascinante e se avrete 
modo di tentare un approccio vi 
accorgerete di quanto siano ben 
strutturate queste librerie. 
Directory:/ SkypeContacts 
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ALFRESCO 1.2.1 

IL CONTENT MANAGEMENT 
SECONDO JSP 

Semplicità è la parola d'ordine per accede- 
re alla logica operativa di Affresco, un 
innovativo sistema di content manage- 
ment che sta riscontrando un certo suc- 
cesso presso gli sviluppatori di tutto il 
mondo. Padre di Affresco è John Newton, 
un nome che tra i "consumatori" di CMS 
dovrebbe suscitare una certa reazione, 
poiché stiamo parlando del cofondatore 
di Documentum, tra i primissimi sistemi 
di content management che già negli anni 
'90 spopolava presso la nicchia degli 
addetti ai lavori. A distanza di tre lustri, le 
cose sono cambiate anche nel mondo 
CMS, dove, a fronte dello sviluppo senza 
limiti di Internet, coinciso con l'esplosione 



*■ a t * 




della filosofia open source, e, con esso, del 
consolidamento del concetto di portale 
come spazio virtuale in cui ospitare conte- 
nuti dalla natura dinamica, si è assistito 
alla proliferazione di strumenti in grado di 
gestire la pubblicazione di informazioni 
senza presupporre la conoscenza di lin- 
guaggi di programmazione semplici o 
complessi. Oggi bastano pochi clic per 
allestire una struttura efficiente da mette- 
re in linea, e trasformare il proprio spazio 
Web in realtà viva e pulsante, alla cui viva- 
cità poter contribuire in maniera diretta 
ed immediata: in quest'ottica, Affresco si 
pone l'obiettivo, ambizioso ma non 
impossibile, di rappresentare un punto 
fermo nel panorama CMS internazionale. 
Tra l'altro, Affresco si offre come sistema di 
sviluppo e pubblicazione di contenuti su 
Web sfruttando le Java Server Faces, l'in- 
novativa tecnologia che nasce con l'obiet- 
tivo di semplificare lo sviluppo di applica- 
zioni Web oriented attraverso il supporto 
di componenti più ricchi e completi che 
migliorino l'aspetto e la funzionalità delle 
interfacce utenti 
Directory:/ Al fresco 



DOTNETNUKE 
4.3.0 

UN FRAMEWORK PER LA 
COSTRUZIONE DI CMS 

Era nato come un semplice CMS ma 
nel tempo si è evoluto in modo rapi- 
dissimo ed è diventato un CMS strut- 
turato in modo piramidale. Chi vuole 
può installarlo come semplice siste- 
ma di Document Management, ed in 
questo senso potrà sfruttare le fun- 
zioni esposte e non sono certamente 
poche. Il layout è molto personaliz- 
zabile, i moduli sono molti e facil- 
mente integrati. Coloro i quali invece 





— r^^ — 










■— .ti^ hp 






— I Filili JSE^H 






^5^^^^ 




- : " : - ■'_" 


— 5 








- jMMM 


fWHWW '•— 


- 




-■-_-=.--*•- 









necessitano di una maggiore perso- 
nalizzazione possono pensare di 
mettere le mani direttamente nei sor- 
genti. Addirittura esiste uno starter 
kit per Microsoft Visual Studio 2005. 
Certamente il codice e complesso e 
persino l'adozione dello Starter Kit 
presenta qualche difficoltà iniziale 
nell'utilizzo, tuttavia superati i primi 
scogli, si avverte subito come la 
modularità del codice e la forte pro- 
pensione alla programmazione 
Object Oriented siano forniscano 
una base di sviluppo sicura e affida- 
bile 
Directory:/ DotNetlMuke 

DRUPAL 4.7.2 

LA NUOVA VERSIONE DELLA 
PIATTAFORMA PER BLOGGERS 
OPENSOURCE 

Un blog è un contenitore singolo di 
informazioni. Una piattaforma per 
bloggers è un sistema che include in 
se più di un blog. Esempi concreti 
possono essere Splender, o Bloggers. 
Drupal è una piattaforma per blog- 
gers scritta in PHP estremamente 
efficiente. Le sue caratteristiche più 
interessanti sono quella della modu- 
larità e della flessibilità del layout. 



Dal punto di vista del programmato- 
re è utile sapere che Drupal espone 
un intero framework per la costruzio- 
ne dei moduli. Se avrete occasione di 
dare uno sguardo ai sorgenti, e agli 
esempi vi accorgerete che il fra- 
mework in questione è concepito in 
maniera assolutamente solida ed è 
stato progettato in maniera estrema- 
mente efficace. Costruire un modulo 
per Drupal non richiede sforzi ecces- 
sivi, il framework nasconderà i detta- 
gli dell'integrazione con il sistema 
principale e vi lascerà concentrare 
solo sulle funzionalità di cui vorrete 
dotare i vostri moduli 
Directory:/ Drupal 

YETANOTHER 
FORUM 1.0.1 

ANCORA UN ALTRO FORUM! 

Il gioco di parole si presta bene per 
marcare la vocazione OpenSource di 
questo progetto. Di fatto, tipicamen- 
te questo genere di gioco di parole 
viene applicato proprio a software 
OpenSource. YetAnotherForum è un 
forum scritto interamente in .NET. Il 
progetto è piuttosto ambizioso e si 
pone sulla scia di progetti ben più 
noti quali phpBB. Tuttavia è impor- 
tante notare oltre alle qualità intrin- 
seche di questo forum che sono vera- 
mente eccellenti, quanto anche in 
ambienti .NET si stia cominciando a 




diffondere il concetto di OpenSource. 
Per quanto riguarda questo partico- 
lare forum, siamo convinti che ben 
presto lo vedremo in versioni riviste e 
migliorate proprio grazie all'apporto 
della community. Per adesso non vi 
resta che provarlo... 
Directory:/yetanotherforum 

PHPBB 

IL FORUM PER ECCELLENZA 

Scritto in PHP con l'ausilio di MySQL 
è stata probabilmente la prima appli- 
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cazione OpenSource a proporre un 
modello per lo sviluppo di forum sul 
Web. 
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Attualmente è probabilmente il pro- 
dotto che espone il maggior numero 
di funzionalità, più facilmente esten- 
dibile e più ricco di moduli. In alcune 
versioni sono stati riscontrati proble- 
mi di sicurezza, tuttavia prontamen- 
te risolti. Se avete bisogno di installa- 
re un forum o più semplicemente 
volete studiare alcune tecniche per 
scrivere codice elegante e funzionale 
in PHP, probabilmente PHPbb è il 
software che fa per voi 
Directory:/ PHPbb 

WIKICALC 0.9.1 

IL PRIMO FOGLIO ELETTRONICO 
COLLABORATIVO 

Dalla geniale mente dei creatori di 
MediaWiki, il software per la scrittura 
di documentazione collaborativa, 
arriva questo WikiCalc, la prima web 
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application che consente di condivi- 
dere esattamente come se fosse un 
wiki, formule, dati e fogli elettronici. 
Si tratta di un modello interessante 
del quale sicuramente sentiremo 
ancora parlare nei prossimi anno. 
Directory:/ WikiCalc 

WORDPRESS 

IL PRIMO BLOG! 

All'inizio c'era PHPNuke, poi sono 
arrivati Xoom e gli altri, e il primo a 



seguire il modello "Blog" che ormai 
conosciamo così bene è stato proba- 
bilmente Wordpress. Si tratta di un 
sistema molto semplice e veloce da 
utilizzare, ma allo stesso tempo 
anche molto completo ed efficace. Se 
non volete incorrere in inutili com- 
plicazioni, è lo strumento che fa per 
voi. 
Directory:/ Wordpress 

JOOMLA 1.0.8 

L'EREDE DI MAMBO 

Nato da una costola del famoso CMS 
Mambo, Joomla sta diventando rapi- 
damente un punto di riferimento per 
coloro che hanno bisogno di un siste- 
ma potente, stabile, altamente perso- 
nalizzabile. Scritto in PHP è compa- 
tibile con tutta una serie di database. 
E' facilmente estendibile grazie alla 
disponibilità di moduli aggiuntivi, ed 
è programmabile grazie al framework 
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che fa da base all'intero CMS. Si trat- 
ta ormai di un prodotto consolidato a 
cui ci si può rivolgere senza troppe 
esitazioni per coprire un elevato 
numero di esigenze 

ECLIPSE SDK 3.1.2 

L'AMBIENTE APERTO 

Eclipse è un IDE "Aperto" multipiat- 
taforma e completamente scritto in 
Java. Per aperto si intende un sistema 
che può essere facilmente espandibi- 
le per mezzo di moduli. Perciò se da 
un lato inizialmente si presenta 
pronto per favorire lo sviluppo di 
applicazioni Java, dall'altro lato tra- 
mite moduli può diventare un como- 
do IDE per PHP oppure per C++ 
oppure per XML, oppure per qualun- 
que altro linguaggio che sia suppor- 
tato da un modulo. In questo numero 
di ioProgrammo lo abbiamo utilizza- 
to in più occasioni ed è ormai diven- 



tato uno standard per ogni program- 
matore Java, tuttavia le estensioni di 
cui dispone incominciano a essere 
veramente notevoli. Unica nota a suo 
demerito, una certa pesantezza che 
caratterizza tutto l'ambiente 
Directory:/ EclipseSDK312 

JAVA 

DEVELOPMENT KIT 
1.5.0 UPGRADE 7 

INDISPENSABILE PER 
PROGRAMMARE IN JAVA. 

Ci corre l'obbligo, prima di tutto, di 
fare i nostri migliori auguri a java che 
ha appena compiuto 10 anni di vita. 
Il linguaggio di Sun nato con l'ambi- 
zione di essere il primo realmente 
multipiattaforma e che portava con 
se la grande ambizione di servire 
qualunque tipo di periferica, dopo 10 
anni di esistenza può dire di avere 
largamente realizzato i suoi obiettivi. 
Con una base di programmatori lar- 
ghissima e con il primato invidiabile 
di essere il linguaggio base per i 
telefonini di nuova generazione 
come per i PC come per i sistemi 
embedded è ad oggi uno dei linguag- 
gi più diffusi al mondo. Per program- 
mare in Java è necessario semplice- 
mente dotarsi del J2SE che vi presen- 
tiamo in questo stesso numero, tutto 
il resto sono AddON, anche se non 
neghiamo che un buon editor aiuta. 
Non vi resta che installare il JDK 
dotarvi di entusiasmo e pazienza e 
creare il vostro primo "Hello Word" 
carta di ingresso del meraviglioso 
mondo di Java. 
Directory:/ J2SE7 

RUBY 1.8.4 

IL LINGUAGGIO EMERGENTE 

Avevamo cominciato a parlarvene nel 
numero 104 di ioProgrammo. Questo 
mese utilizziamo Ruby per sviluppare 
un bot per skype. Se avrete la pazienza 
di leggere l'articolo, scoprirete quanto 
sia facile con Ruby accedere ad un web 
services, interfacciarsi con oggetti 
COM, gestire l'intero ciclo dello svilup- 
po. E' in linguaggio veramente interes- 
sante sul quale vi chiediamo di farci 
conoscere le vostre impressioni e che vi 
invitiamo a provare anche in caso di 
progetti in produzione 
Directory:/ Ruby 
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IL DILEMMA 
DEL PRIGIONIERO 

CI SIETE VOI, IL VOSTRO COMPARE E IL BANCO. AVETE A DISPOSIZIONE DUE CARTE: 
"TRADISCI" E "COLLABORA", I PUNTI LI DA IL BANCO. SE LE CARTE CORRISPONDONO 
FORSE CE LA FATE, ALRIMENTI... DIAMO UNO SGUARDO AD UN ALGORITMO CLASSICO 



E pensare che era quasi fatta... Dopo una dura vi- 
ta di furti e ruberie, Al e Jack pensavano di chiu- 
dere la società con un'ultima rapina in banca. E 
invece eccoli lì, pizzicati dopo il colpo, interrogati dal- 
la polizia in stanze separate. Ma non tutto è perduto: 
alla polizia mancano le prove. 
Sotto la lampada dell'interrogatorio, i due non per- 
dono il loro sangue freddo, né le loro notevoli capa- 
cità logiche. "Potrei tradire il mio socio", riflette Al. 
"Uscirei subito di galera e mi godrei il malloppo per 
conto mio mentre lui marcisce dietro le sbarre. Op- 
pure potrei tenere la bocca cucita, scontare una piccola 
pena per porto d'armi illegale e dividere il grisbì con il 
mio compare... Sempre che lui non mi tradisca, nel 
qual caso la mia pena sarebbe durissima e quel diso- 
nesto di Jack terrebbe i soldi tutti per sé". Jack, nel frat- 
tempo, fa esattamente gli stessi ragionamenti. 
Cosa faranno Al e Jack? Sceglieranno di spifferare tut- 
to, o terranno il becco chiuso? Questo dubbio ha ap- 
passionato per oltre vent'anni economisti, biologi e 
matematici. 



IL CRIMINE PAGA 

Il classico Dilemma del Prigioniero funziona così: ci 
sono due giocatori e un banco. Ciascun giocatore ha 
due carte: una carta C ("Collabora") e una carta T ("Tra- 
disci"). Entrambi i giocatori giocano una carta coper- 
ta. Il banco scopre le due carte, e in base al risultato 
assegna un "premio" o una "punizione" a ciascun gio- 
catore. Se entrambi collaborano (giocano C), a tutti e 
due tocca un modesto "Premio per la Collaborazio- 
ne". Se entrambi tradiscono (giocano T), a ciascuno 
andrà una modesta "Punizione per il Tradimento". Se 
uno dei due gioca T e l'altro gioca C, chi ha tradito 
prende una corposa sommetta, la "Tentazione per il Tra- 
dimento"; chi ha ingenuamente collaborato si becca 
una dura punizione, che chiameremo la "Stangata del- 
l'Allocco". Non esistono altre possibilità: i giocatori 
possono giocare solo CC, TT, CT o TC. Entro certi li- 
miti, non è importante a quanto ammontano esatta- 



mente i premi e le punizioni, e nemmeno se le puni- 
zioni siano delle vere punizioni o semplicemente dei 
premi di valore più basso. Tutti i premi possono esse- 
re espressi in "punti". Possiamo assegnare punti per 
la Stangata, 1 per la Punizione, 3 per il Premio e 5 per 
la Tentazione. In figura 1 puoi vedere una semplice ta- 
bella dei premi in base alle giocate. 
Ora diciamo che voi siete Al. Sapete che Jack è un tipo 
senza tanti scrupoli, che farà solo il proprio interesse. 
Anche voi, d'altra parte, non siete uno stinco di santo. 
Cosa giochereste? Provate a pensarci un po' prima di 
dare la risposta. 

Se io fossi Al, non avrei dubbi. Il mio ragionamento 
sarebbe questo. Poniamo che Jack giochi T. Allora an- 
che a me converrebbe giocare T. Ci beccheremo en- 
trambi la Punizione per il Tradimento, ma sarebbe 
sempre meglio della Stangata che prenderei giocando 
C. E se Jack dovesse generosamente giocare C? Be', mi 
converrebbe comunque giocare T. Il povero Jack si 
beccherebbe la Stangata, e io me ne tornerei a casa 
con la Tentazione per il Tradimento. Se avessi giocato 
C avrei dovuto accontentarmi del meno consistente 
Premio per la Collaborazione. Insomma, non si scap- 
pa: è triste dirlo, ma comunque la si giri mi conver- 
rebbe tradire il mio ex socio. Ecco perché il Dilemma 
del Prigioniero è considerato un paradosso: non ci so- 
no modi di uscirne puliti. A meno che Al e Jack non si 
siano messi d'accordo e possano fidarsi ciecamente 
l'uno dell'altro, lo scenario ideale di una piena colla- 
borazione non è realizzabile in pratica. Qualcuno sarà 
stangato. Ma è davvero così? 



GUERRE FREDDE 
E UCCELLI PULCIOSI 

Il motivo per cui il Dilemma del Prigioniero è così af- 
fascinante è che il mondo reale ne è pieno. In parti- 
colare, gli economisti trovano Dilemmi come questo 
ovunque. Se la mia azienda è in concorrenza diretta 
con un'altra, mi conviene o no fare pubblicità? La pub- 
blicità costa, ma se io faccio pubblicità e il mio con- 
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corrente no, sarà un bel colpo per noi e una stangata 
per lui (TC). Se entrambi facciamo pubblicità (TT), 
spendiamo soldi per lasciare la situazione più o meno 
com'è. Se nessuno dei due la fa (CC), la situazione re- 
sta com'è ma risparmiamo i soldi. Ci converrebbe col- 
laborare entrambi e non fare pubblicità, ma non pos- 
siamo esporci al rischio che il concorrente "tradisca". 
Il Dilemma salta fuori ovunque anche in politica. Un 
caso classico è la Guerra Fredda. America e URSS avreb- 
bero potuto diminuire le spese per gli armamenti, ma 
questo li esponeva al rischio che l'avversario conti- 
nuasse a studiare armi più sofisticate per l'attacco fi- 
nale. Sarebbe stato meglio per tutti smettere di co- 
struire armi, eppure la corsa al riarmo continuava. Al- 
la fine uno dei due contendenti è uscito di scena per 
altri motivi, ed stata è una fortuna: il Dilemma del Pri- 
gioniero insegna che ad entrambi sarebbe convenu- 
to attaccare per primi alle prime avvisaglie di "tradimento" 
dell'avversario. 

Un altro campo nel quale il dilemma salta fuori spes- 
so è la biologia. Richard Dawkins (vedi box: "Il gene 
egoista") descrive una specie di uccelli afflitta da un 
dilemma morale. Ciascun uccello riesce a spulciarsi 
col becco in tutto il corpo, tranne che in un punto: la 
cima della testa. Può farsi spulciare la testa da un ami- 
co, e ricambiargli il favore. Spulciare gli altri costa tem- 
po, ma alla fine conviene a tutti. Se però un uccello si 
trova davanti ad un traditore, allora prenderà una Stan- 
gata: perderà tempo per spulciare l'altro, ma alla fine 
si terrà la testa pulciosa. 

La cieca selezione genetica avrebbe dovuto punire du- 
ramente l'altruismo in casi come questo. La fredda lo- 
gica del Dilemma ci dice che a nessuno conviene col- 
laborare. In una popolazione di animali altruisti, un 
egoista avrebbe vita comodissima: non farebbe alcu- 
na fatica a spulciare gli altri, e sarebbe sempre ben 
spulciato. Questo animale antipatico sarebbe favori- 
to dalla selezione naturale, e avrebbe più probabilità 
degli altri di riprodursi anziché morire per qualche 
malattia portata dalle pulci. Riproducendosi, passe- 
rebbe ai suoi figli il "gene dell'egoismo" anziché quel- 
lo che porta l'istinto di spulciamento reciproco. Nel 
corso delle generazioni l'egoismo dovrebbe diffon- 
dersi tra la popolazione, mentre l'altruismo, svantag- 
giato, finirebbe per soccombere. La cosa strana, però, 
è che in natura molte specie di uccelli e altri animali si 
spulciano generosamente a vicenda. Perché, dunque, 
questo istinto dell'altruismo ha prosperato anziché 
estinguersi? 

L'egoismo ha un problema. Senza dubbio, un egoista 
in una popolazione di altruisti fa una gran bella vita. Ma 
se il nostro egoista diffonde il suo codice genetico, pre- 
sto non sarà più l'unico egoista della combriccola. Do- 
po qualche generazione, gli egoisti saranno tanti. E 
mentre un egoista in una popolazione di altruisti pro- 
spera, un egoista in una popolazione di egoisti è nei 
guai. Il nostro egoista non dovrebbe pagare il prezzo di 
spulciare gli altri, ma questo gli sarebbe poca conso- 



lazione nel momento in cui dovesse morire di pulci 
lui stesso perché non trova in giro abbastanza altrui- 
sti disposti a spulciarlo. Per usare un termine da bio- 
logo, l'egoismo nello spulciamento non è una Strate- 
gia Evolutivamente Stabile (ESS), nel senso che non è 
"sostenibile". Gli egoisti vanno alla grande per un po', 
e poi si mettono nei guai da soli. 
Che differenza c'è tra questa situazione e il Dilemma 
che abbiamo descritto? Una sola: il Dilemma si gioca 
una volta sola, o la va o la spacca. Le situazioni che si 
trovano in natura si giocano continuamente. E' come 
se avessimo tante partite di Dilemma del Prigioniero 
in sequenza. Questo fa tutta la differenza, perché non 
posso più sperare che un tradimento passi impunito. 
Se tradisco in un turno, posso aspettarmi ritorsioni 
nel turno successivo. Forse, in queste condizioni, l'al- 
truismo paga? Cerchiamo di scoprirlo con l'aiuto di 
un computer. 



CRIMINI E VENDETTE 

La variante del Dilemma che ci interessa si chiama Di- 
lemma del Prigioniero iterativo. È come una serie di 
partite del Dilemma giocate in sequenza. Alla fine, chi 
ha più punti vince. Tutto qui, a parte poche regole ag- 
giuntive (per conoscerle, leggi il box: "L'ombra del fu- 
turo"). Il dilemma iterativo fu proposto nel 19XX, e su- 
bito messo alla prova con un concorso tra programmi 
per computer. Ciascun programma giocava con una 
strategia diversa, e dovette giocare contro tutti i propri 
avversari. Alla fine emerse un chiaro vincitore. Il gio- 
co è interessante, e vale la pena di provarlo. Possiamo 
scrivere un semplice programma Java per giocare del- 
le partite di Dilemma Iterativo. Per prima cosa defi- 
niamo le mosse (in Java 5) : 

public enum Mossa { 
C, T; 



Ecco la classe base per tutte le strategie di gioco: 



public abstract class Prigioniero { 
public int punti = 0; 
public abstract Mossa gioca(); 
public void mossaAvversaria(Mossa m) { 
} 



@Override 

public String toString() { 

return getClass().getSimplel\lame(); 



} 



Ciascun Prigioniero ricorda quanti punti ha. Il me- 
todo giocaO, che è astratto e va implementato dal- 
le sottoclassi, restituisce la prossima mossa. Il me- 
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todo mossaAwersariaO serve al banco per infor- 
mare il giocatore dell'ultima mossa dell'avversa- 
rio. Come abbiamo accennato, questa può essere 
un'informazione importante per un giocatore, ma 
di default questo metodo non fa niente (il gioca- 
tore non ha memoria delle mosse passate) . Il me- 
todo toStringO restituisce semplicemente il nome 
della classe. Ora ci serve un programma per gesti- 
re l'intera partita: 

public class DilemmaDelPrigioniero { 

public final static int TENTAZIONE = 5; 

public final static int PREMIO = 3; 



public final static int PUNIZIONE : 



public final static int FREGATURA = 0; 



public final static int TURNI = 100000; 
final Prigioniero al; 
final Prigioniero jack; 



public DilemmaDelPrigioniero(Prigioniero pi, 
Prigioniero p2) { 
al = prigionierol; 
jack = prigioniero2; 

} 

private void gioca() { 

for (int i = 0; i < TURNI; i ++) giocaTurno(); 

calcolaRisultato(al.toString(), al. punti); 

calcolaRisultato(jack.toString(), jack. punti); 

calcolaRisultato("Totale: ", al. punti + jack.punti); 
} 



private void calcolaRisultato(String messaggio, 

int punti) { 
float risultato; 

if (punti == 0) 

risultato = 0; 
else 

risultato = (float) punti / (PREMIO * TURNI) * 

100; 

System. out.println(messaggio + ": " + risultato); 



} else if (mossaAl == Mossa. C && mossaJack = = 

Mossa T) { 


al. punti + = 


: FREGATURA; 


jack.punti ■ 


f= TENTAZIONE; 


} else if (mossaAl == Mossa.T && mossaJack = = 

Mossa. C) { 


al. punti + = 


: TENTAZIONE; 


jack.punti ■ 


f = FREGATURA; 


} 


System. out.p 


rintln(mossaAl.toString() + 

mossaJack. toString() + " (" 


+ al + ": 


" + al. punti + ", " + jack + ": " + 

jack.punti + ")"); 


} 



ALCUNI DILEMMI 

Non ci rimane che estendere la classe Prigioniero, si- 
mulando il e aso in cui il giocatore muova in modo 
random, oppure sia sempre collaborativo oppure sia 
vendicativo 



public class Casuale extends Prigioniero { 
public Mossa gioca() { 

if (Math.random() >= 0.5) 

return Mossa. C; 
else 

return Mossa.T; 



} 



public class Santo extends Prigioniero { 



public Mossa giocaQ { 



return Mossa. C; 



il nostro main sarà il seguente 



public static void main(String[] args) { 
new 

DilemmaDelPrigioniero( 



DilemmaDelPrigioniero d : 



new CasualeQ, new CasualeQ); 




d. giocaQ; 



private void giocaTurnoQ { 



Mossa mossaAl = al. giocaQ; 



Mossa mossaJack = jack. giocaQ; 



al.mossaAvversaria(mossaJack); 



jack.mossaAvversaria(mossaAI); 



if (mossaAl == Mossa. C && mossaJack == Mossa. C) 



{ 



al. punti += PREMIO; 



jack.punti += PREMIO; 



} else if (mossaAl == Mossa.T && mossaJack = = 

Mossa.T) { 



al. punti += PUNIZIONE; 



jack.punti += PUNIZIONE; 



CONCLUSIONI 

Abbiamo proposto un paio di strategie, ma ancora 
non abbiamo elaborato un vincitore, vi lasciamo il 
compito di trovarlo. Esistono strategie diverse e solu- 
zioni diverse. Indagate pure su 1 dilemma del prigio- 
niero e fateci sapere attraverso il nostro forum quali 
sono le soluzioni da voi individuate e come possono 
essere applicate. 



Paolo Perrotta 
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ALGORITMI GREEDY 

GLI ALGORITMI GREEDY GARANTISCONO PER SVARIATE CLASSI DI PROBLEMI UNA 
SOLUZIONE. SPESSO PRODUCONO SOLUZIONI POLINOMIALI PER PROBLEMI COMPLESSI, 
COLLOCANDOSI NELLA CATEGORIA DEGLI NP-COMPLETI. 
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Il modo di affrontare un problema ne individua la 
tecnica. Tra queste pagine abbiamo esplorato mol- 
te delle tecniche utilizzate nel mondo della pro- 
grammazione. È arrivato il turno degli algoritmi greedy. 
Tali algoritmi ricercano la soluzione finale scegliendo 
ad ogni passo una soluzione ottimale. Ad ogni passo 
quindi, si procede scegliendo l'opzione più appetibi- 
le, più golosa (dalla traduzione del termine greedy de- 
riva il sinonimo "algoritmo goloso"). Sgomberiamo 
subito il campo da pericolosi equivoci. Come vedremo 
con esempi, la scelta ad ogni iterazione della soluzio- 
ne ottimale non garantisce la soluzione ottima fina- 
le. Ad ogni modo vedremo che si tratta di un metodo 
prezioso poiché, anche se non ottima, in molte situa- 
zioni viene garantito il risultato in tempi polinomiali 
e quindi con tempi di computazione accettabili. L'a- 
nalisi della complessità e lo studio di alcuni esempi 
applicati al metodo verranno presentati nei prossimi 
paragrafi. 



ALGORITMO GREEDY 

Il problema di Knapsack può essere risolto attraver- 
so un algoritmo greedy. Si tratta del problema del la- 
dro che avendo un sacco con una capacità massima di 
peso oltre la quale il sacco si rompe deve rubare degli 
oggetti preziosi da un fissato insieme ognuno dei qua- 
li ha un valore ed un peso. Ovviamente, lo scopo è 
quello di massimizzare il valore della refurtiva ba- 



COSA VUOL DIRE RCPSP? 



RCPSP acronimo di Resource 
Constrained Project Scheduling 
Problem, rappresenta una classe 
di problemi che ha come 
obiettivo la minimizzazione della 
durata del progetto in presenza di 
vincoli sulle risorse e di vincoli di 
precedenza. In generale risolvere 
un RCPSP significa ricercare uno 
schedulatore ottimo per le 
attività del progetto che soddisfi 
i vincoli di precedenza e provveda 
ad una corretta allocazione delle 
risorse disponibili quali: 
manodopera, materie prime. 



budget macchinari, 
equipaggiamenti, e altro ancora. 
La pratica dimostra che problemi 
reali, per progetti anche di media 
grandezza portano ad esaminare 
un elevato numero di variabili 
che rendono il problema 
immediatamente di elevata 
complessità, il che lo colloca tra 
gli NP-Hard. Si affronta quindi il 
problema ricorrendo ad approcci 
euristici che spesso costringono a 
sacrificare la qualità della 
soluzione a scapito di tempi di 
esecuzione accettabili. 



dando a non violare il vincolo del peso, ossia non su- 
perare la capacità massima dello zaino. Anche il pro- 
blema del commesso viaggiatore trova una soluzione 
con l'algoritmo greedy. Questo è il problema di un 
commesso viaggiatore che deve effettuare delle con- 
segne in determinati luoghi e quindi deve passare per 
ognuno di essi, cercando di trovare il percorso minimo. 
Qui, il vincolo è che si debba passare una sola volta 
per ognuno dei luoghi. Per il problema del ladro un 
approccio "goloso" consiglierebbe di mettere nel sac- 
co, purché ci entri, ad ogni passo dell'algoritmo l'og- 
getto di massimo valore. Facciamo un esempio. Sup- 
poniamo che il ladro abbia una sacca si capacità 20 
Kg e che gli oggetti siano 4, con valore e peso come 
descritto dalla tabella riportata di seguito. 



Valore 


Peso Kg 


100 


15 


60 


8 


50 


9 


10 


2 



Secondo la logica greedy si inserisce nel sacco prima 
il prezioso di maggiore valore: 100, dal peso 15. Suc- 
cessivamente, si provano a inserire gli altri oggetti di va- 
lore minore 60, e 50, ma entrambi non soddisfano il 
vincolo del peso, cosicché si opta per la l'oggetto di 
minore valore 10 con peso 2. In definitiva il valore com- 
plessivo del maltolto è 1 10 e il peso 17. È utile far no- 
tare che un simile approccio non sempre fornisce so- 
luzione ottima. Nel caso specifico una soluzione al- 
ternativa è inserire nello zaino gli ultimi tre oggetti che 
hanno peso 19, ma valore maggiore del precedente 
110, esattamente 120. 

Quindi in generale un algoritmo greedy può essere 
descritto dai seguenti punti: 

1 . Trovare ad ogni passo un insieme di soluzioni am- 
missibili; 

2 . Stabilire una funzione per individuare la migliore so- 
luzione; 

3. Scegliere tra le soluzioni la migliore (la più golosa) ; 

4. Verificare gli eventuali vincoli; 

5. Definire un criterio di uscita; 

La schematizzazione sicuramente rende più com- 
prensibile le attività da svolgere. Inoltre, ci suggerisce 
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alcune considerazioni. Al punto 2 la funzione per in- 
dividuare la soluzione più "ghiotta" può definire il ve- 
ro discriminante dell'efficienza dell'algoritmo. Ad 
esempio, per il problema del ladro appena descritto 
non è scontato che la funzione debba essere il mag- 
gior valore. Si potrebbe ad esempio studiare una fun- 
zione che tenga conto anche del peso. 



so)<=cap)) 



{ max=valori[i]; 



}; 



if (max!=0) 



{ nel_sacco[imax]=true; 



peso=peso+pesi[imax]; 



pezzi++; 



PURO KIUAPSACK GREEDY 

Una soluzione greedy di Knapsack così come descrit- 
to può essere facilmente implementata. Facciamolo in 
C++. La struttura dati dovrà prevedere due vettori per 
contenere i pesi e i valori degli n oggetti e un altro vet- 
tore di booleani che indica se un oggetto si trova o me- 
no nel sacco. Variabili globali sono: il peso attuale de- 
gli oggetti nel sacco (peso); la capacità massima del 
sacco (cap); il numero di pezzi rubati (pezzi); e il nu- 
mero totale di oggetti (n). 

int main() 

i 

// struttura dati e variabili globali 

const int nmax=100; 

int pesi[nmax]; 

int valori[nmax]; 

bool nel_sacco[nmax]; 

int peso, cap, pezzi, n; 

// variabili di lavoro 

int max, imax, i; 



Dopo aver letto i vettori pesi e valori e le variabili cap 
e n ed aver inizializzato a false il vettore nel_sacco, l'al- 
goritmo prevede un ciclo esterno ad ogni iterazione 
del quale viene collocato un oggetto all'interno del 
sacco. Si uscirà dal ciclo quando non sarà possibile 
collocare alcun elemento, oppure quando siano stati 
collocati ormai tutti (eventualità questa degenere) i 
preziosi . Si suppone come logica suggerisce che i va- 
lori siano tutti positivi, così sarà sufficiente inizializzare 
ad ogni iterazione il valore massimo pari a zero. Se il va- 
lore osservato è maggiore di max e non è dentro lo zai- 
no e il suo peso non sfonda il sacco stesso allora lo si 
pone al suo interno. Si aggiorna il vettore di booleani 
il peso attuale e il numero di pezzi. Se alla fine del ci- 
clo interno la variabile max è rimasta a zero vorrà di- 
re che non è stato possibile collocare alcun oggetto 
nel sacco. Con questa condizione usciamo anche dal 
ciclo principale. 

// .... Input 

pezzi=0; 

peso=0; 

while ( (pezzi<=n) && (max!=0)) 



{ max=0; // si suppongono valori positivi 



// ... Output 



}; 



C: \aaVedmaster\ioprogrammo\ri_1 5\soluz\ 



minerò di oggetti — > 4 
capacito del sacco — > 20 



ualore [0] 



peso [0] — > 15 
ualore [1] — > 60 



ualore [2] — > 50 



peso [2] — > 9 

ualore [3] — > 10 

I peso [3] — > 2 

Peso occupato : 17 

oggetto 0, ualore: 100, peso 

oggetto 3, ualore: 10, peso: 



Fig. 1: "Output del programma greedy knapsack" 

La soluzione ha una complessità 0(n*n), ma con alcuni 
accorgimenti sul calcolo del massimo può ancora mi- 
gliorare. Il quadrato di n si ha per la presenza del dop- 
pio ciclo innestato. 



KNAPSACK FRAZIONARI 



L'accezione 0/1 che si trova in 
letteratura associata a 
Knapsack problem indica la 
variante più diffusa, e cioè 
quella che prevede una logica 
binaria rispetto ad ogni 



oggetto, ossia se è presente o 
meno nel sacco (uno o zero). 
Qualora sia lecito considerare 
una parte di oggetto si ha a che 
fare con la variante frazionaria 
di Knapsack problem. 



for (i=0; i<n; i++) 



if ((!nel_sacco[i]) && (valori[i]>max) && ((pesi[i]+p 



UNA SOLUZIONE 
DINAMICA 

Un'altra soluzione prevede l'esplorazione di tutte le 
soluzioni. Si tratta di individuare tutte le possibili com- 
binazioni. Un puro problema di calcolo combinatorio. 
Quindi scegliere quella che massimizzi il valore. Tale 
soluzione presenta una complessità elevata conside- 
rata la natura esponenziale del calcolo combinatorio 
da effettuare. Più precisamente si riscontra 0(2n). 
Esistono modi alternativi per risolvere il problema 
knapsack, tra questi interessante è la soluzione con 



http://www.ioprogrammo.it 



Agosto 2006/ in > 



SOLUZIONI T I Risoluzione di problemi per passi 




programmazione dinamica. Esaminiamolo in modo 
da fare qualche confronto. Il nodo della questione è 
individuare ed esplorare in modo opportuno i sot- 
toinsiemi di dimensione m, possibili soluzione otti- 
me. La dimensione m del sottoinsieme ottimo non 
conta in fase di sviluppo dell'algoritmo. I due indici i 
e k rispettivamente generalizzeranno cap e n, e ver- 
ranno usati nelle istruzioni cicliche per scorrere negli 
intervalli che tali valori definiranno. Il metodo usato è 
definito ricorsivamente. Una matrice raccoglie i dati par- 
ziali, al termine dell'elaborazione conterrà anche la 
soluzione; di nome sp. Ecco come si ottiene ricorsi- 
vamente un generico valore di sp. Esso è assegnato in 
funzione della condizione d[k]>i come segue. 

sp[k, i]=sp[k-l, i] sed[k]>i 

sp[k, i]=max(sp[k-l,i], sp[k-l,i-d[k]]+ v[k] ) 

negli altri casi 

La riga k della matrice indica che stiamo elaborando 
la soluzione con k oggetti nel sacco, cosicché siamo 
in grado di trovare le soluzioni ottime per ogni k. L'im- 
plementazione della definizione matematica è a que- 
sto punto scontata. Tralasciando l'ovvia dichiarazione 
e l'input dei vettori dei pesi e dei valori, possiamo scri- 
vere: 



for (i=0; i<cap; i++) 

sp[0][i]=0; 

for(k=0; k<n; k++) 

J 

sp[k,0]:=0; 

for (i=0; i<cap; i++) 
if (d[k]<=i) // Può far parte della soluzione 

if (v[k]+sp[k-l, i-d[k]]>sp[k-l,i]) 

sp[k,i]=v[k]+sp[k-l,i-d[k]] 

elsesp[k,i]=sp[k-l,i] 
else sp[k,i]=sp[k-l,i] // Se d[k]>i 



Il ciclo su k individua le soluzioni ottime per ogni am- 
piezza del sottoinsieme di soluzioni (numero di og- 
getti nel sacco) . Il ciclo interno su i scorre fino ad arri- 
vare alla capienza del sacco, ad ogni iterazione verifi- 
ca se un generico oggetto può far parte della soluzio- 
ne; in caso affermativo mediante un nuovo control- 
lo, trova la soluzione più vantaggiosa in termini di va- 
lori. L'analisi della complessità evidenzia che la pri- 
ma fase di azzeramento consta O(Cap) così come il 
secondo for su i. Questo ultimo ciclo si trova innesta- 
to in un altro ciclo di n iterazioni. Quindi l'intero bloc- 
co sarà 0(n*Cap) che ovviamente risulta essere un ri- 
sultato migliore di 0(2n) . Ad ogni modo non è confor- 
tante in termini computazionali il fatto che la com- 
plessità dipenda da cap (ampiezza del sacco), questo 
porta ad una significativa dipendenza delle presta- 



zioni dell'algoritmo dai dati usati. Altri metodi inve- 
ce non soffrono tale fattore negativo. 



PROBLEMA 
DEL COMMESSO 
VIAGGIATORE 

È uno dei problemi più conosciuti nel mondo del- 
l'informatica. Dall'inglese Travelling Salesman Pro- 
blem (TSP) . Vi sono molti modi per formularlo. Uno dei 
migliori, oltre quello precedentemente introdotto, fa 
uso dei grafi. Dato un grafo costituito da n nodi e da un 
insieme di archi pesati, si vuole trovare un cammino 
tale che tutti i nodi siano visitati una sola volta (si par- 
la di ciclo Hamiltoniano) e il costo sugli archi sia mi- 
nimo. Questa ultima condizione equivale a dire tro- 
vare il percorso minimo se il peso dell'arco è la di- 
stanza. Prima ancora di proseguire vediamo qualche 
altre formulazioni. Il problema dello schedulatore, o me- 
glio quello di sequenziare n lavori su una macchina 
non è altro che TSP dove i nodi sono le attività da svol- 
gere e gli archi i tempi di attesa o set-up per risolver- 
le. Nelle applicazioni di foratura o di rifinitura auto- 
matica eseguite da robot, i nodi sono pezzi da rifinire 
o fori (di varie dimensioni) da praticare, e il costo del- 
l'arco include i necessari tempi morti. La teoria sul 
problema è molto ricca e richiederebbe molto spazio 
per essere esplorata nei suoi punti fondamentali. Ma 
vediamo le cose essenziali e soprattutto l'attinenza 
con l'oggetto dei nostri interessi, gli algoritmi greedy. 
Il problema può essere asimmetrico e simmetrico a 
seconda se il grafo è orientato o meno. Consideriamo 
che il grafo non sia simmetrico. La soluzione ottima- 
le al problema si ottiene se si esaminano tutte le pos- 
sibili soluzioni e tra queste si sceglie quella a costo mi- 
nore, anche se impraticabile. In tal caso se consideriamo 
che il grafo sia completo, ovvero che ogni nodo è con- 
nesso ad ogni altro nodo ci rendiamo subito delle in- 
sormontabili difficoltà. Infatti, i possibili percorsi so- 
no esattamente il fattoriale di n- 1. Tale numero forni- 
sce soluzioni intrattabili per n che superano numeri a 
due cifre, figuriamoci per reti che prevedono mappe di 
nazioni reali per le quali vi sono centinai di città. Bisogna 
quindi aggiustare la mira. Una buona soluzione è for- 
nita applicando algoritmi greedy. Questo per un grafo 
completo può essere così descritto 

1. Parto da un nodo 

2. Valuto tutte le distanze dal nodo dove mi trovo a 
tutti gli altri nodi non visitati 

3 . Svelgo la distanza minima 

4. Ripeto il punto due fin quando non sono termina- 
ti i nodi. 

Altre soluzioni appartengono alla famiglia delle euri- 
stiche, ossia soluzioni che non garantiscono la soluzione 
ottimale ma una soluzione che si avvicina a quella ot- 
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timale con un certo grado di probabilità stimabile. Ma 
soprattutto garantiscono tempi di computazione ac- 
cettabili. Si pensi ai navigatori satellitari. Ad un'inter- 
rogazione dell'utente non sono ammissibili tempi di 
risposta eccessivi. In tal caso si usano algoritmi euri- 
stici. Ne esistono di diversi. Euristiche costruttive co- 
me nearest neighbour che usa metodi greedy proprio 
perché ad ogni passi si sceglie tra i nodi più vicini. Il 
comportamento è mediamente buono, anche se è 
sempre trovare un esempio negativo per il quale il me- 
todo si comporta in modo catastrofico. Euristiche con 
raffinamenti successivi, fanno parte di questa fami- 
glia gli algoritmi Pairwise exchange, Lin e Kernighan, 
e k-opt. Interessanti sono anche i raffinamenti casuali 
che si rifanno ai processi markoviani. Va infine citato 
l'algoritmo di Christofides che ipotizza che sia sem- 
pre verificata la disuguaglianza triangolare che in fin 
dei conti non è un vincolo molto restrittivo. In tal ca- 
so in tempo polinomiale si produce un percorso al più 
1.5 volte quello ottimo. È stato dimostrato che TSP è un 
problema NP- difficile e la versione decisionale del 
problema ("dati i pesi e un numero x, decidere se ci 
sia una soluzione migliore di x") è NP-completa. Il pro- 
blema rimane NP- difficile anche in molte sue versio- 
ni ridotte, come nel caso in cui le città siano in un pia- 
no con distanze euclidee. Inoltre, omettere la condizione 
di visitare una città "una e una sola volta" non rimuove 
la NP- difficoltà, poiché si nota facilmente che nel ca- 
so piano un cammino ottimale visiterebbe comun- 
que le città una volta sola. 



PROBLEMI PENP 

Sappiamo che la teoria della complessità compu- 
tazionale è quella parte della teoria della compu- 
tazione che studia la quantità di risorse richieste 
durante una computazione per risolvere un dato pro- 
blema. Le risorse oggetto di studio sono lo spazio 
(quanta memoria è necessaria per risolvere un pro- 
blema) e il tempo (quanti passi- istruzioni ele- 
mentari- sono necessarie a risolvere un proble- 
ma). Se il tempo impiegato da una macchina de- 
terministica è polinomiale rispetto alla dimensio- 
ne della struttura dati di input si ha la classe P; la clas- 
se NR volendo semplificare, consiste di tutti quei pro- 
blemi di decisione le cui soluzioni positive posso- 
no essere verificate in tempo polinomiale avendo 
le giuste informazioni, o equivalentemente, la cui 
soluzione può essere trovata in tempo polinomia- 
le con una macchina non deterministica (la mac- 
china diTuring non deterministica si distingue da 
quella deterministica definita in precedenza per il 
fatto che, in presenza di un determinato stato e di 
un determinato carattere letto, essa permette più 
transizioni) . Un problema da un milione di dolla- 
ri (sul serio) è sapere se: P è uguale a NP? Quando 
nel 1971 fu introdotto il problema si era molto ot- 



timisti sulla possibile soluzione in tempi brevi. Og- 
gi la maggior parte degli studiosi è orientata dare ri- 
sposta no, mentre più pragmaticamente altri pen- 
sano che la domanda possa essere indecidibile ri- 
spetto agli assiomi correntemente accettati. Il gran- 
de logico Kurt Godei, invece, in una lettera a John 
von Neumann, riteneva plausibile l'ipotesi P=NP. 
Un premio di un milione di dollari è stato offerto per 
la soluzione corretta (si tratta di uno dei problemi 
del millennio). 

Un ruolo importante in questa discussione è gio- 
cato dall'insieme dei problemi NP-completi, che 
semplificando possono essere descritti come quei 
problemi in NP che meno probabilmente appar- 
tengono anche a P. Gli informatici teorici hanno 
dimostrato che se P è diverso da NP, allora nessun 
problema NP- completo appartiene a P. La lettera- 
tura si è arricchita molto sulla questione, sono sta- 
te introdotte infatti importanti classificazioni. È 
stato osservato che molti dei problemi che stava- 
no nella classe NP hanno una stessa struttura: la 
costruzione della soluzione con un algoritmo non 
deterministico e la verifica della soluzione costruita 
con un algoritmo deterministico. Ci si chiedeva 
quindi se ci fossero elementi comuni in questi pro- 
blemi, e in effetti c'erano. Sono stati individuati 
problemi molto particolari. Un algoritmo per ri- 
solvere uno di questi problemi può essere conver- 
tito in un algoritmo per risolvere un qualunque 
problema NP. Questi problemi sono stati detti NP- 
difficili (NP-hard). Un problema NP-difficile po- 
trebbe anche non essere appartenente all'insieme 
NP, nel senso che la verifica della soluzione o equi- 
valentemente 1' "algoritmo di Gastone" (ogni volta 
che si deve fare una scelta, si indovina sempre la 
strada corretta) potrebbe richiedere un tempo più 
che polinomiale. Per dimostrare questa sorta di 
equivalenza, ci si riconduce alla teoria dei linguaggi, 
e si sfrutta il concetto di riduzione. 
È interessante notare che quasi tutti i problemi NP 
sono anche NP-completi; l'unica eccezione nota, 
per ora, è l'isomorfismo di grafi, per il quale nessuno 
è ancora riuscito a dimostrare né la completezza, 
né l'eventuale appartenenza alla classe P. Ricordo 
anche la primalità dei numeri trattata tra queste 
pagine ha avuto una brillante dimostrazione nel 
2002, che spostava il problema in P. Il problema 
del commesso viaggiatore come detto è NP-com- 
pleto. Un tentativo interessante è la ricerca di un al- 
goritmo polinomiale per la soluzione di uno qua- 
lunque dei problemi NP-completi: questo fareb- 
be automaticamente fatto collassare tutta la clas- 
se di problemi NP nella classe P. Ovviamente nes- 
suno è riuscito a trovarne uno, né nessuno è mai riu- 
scito a dimostrare che P include NP, sebbene mol- 
ti esperti sospettino che questa sia la relazione tra 
le due classi. 

Fabio Grimaldi 




LA SFIDA DEL 
MILLENNIO 

In modo del tutto 
analogo alla epica 
sfida lanciata da 
Hilber ad inizio 
secolo scorso, 
l'istituto 

matematico Clay ha 
proposto una nuova 
sfida del millennio. 
Chiunque riuscisse a 
risolvere uno dei 
sotto elencati 
problemi o 
congetture 
vincerebbe il premio 
di un milione di 
dollari. Tra questi 
spicca il problema 
tutto informatico P 
vs NP. 

• P contro NP 

• Congettura di 
Hodge 

• Congettura di 
Poincaré 

• Ipotesi di Riemann 

• Teoria di Yang-Mills 

• Equazioni di 
Navier-Stokes 

• Congettura di Birch 
e Swinnerton-Dyer 
Chi ne vuole saper di 
più può riferirsi al 
seguente indirizzo 
http://www.claymath.o 
rg/ e proseguire alla 
voce 
awards\millenium 
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